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软件 质量 ， 不 但 依赖 于 架构 及 项 目 管理 ， 而 且 与 代码 质量 紧密 相 
关 。 这 一 点 ， 无 论 是 敏捷 开发 流派 还 是 传统 开发 流派 ， 都 不 得 不 承认 。 

本 书 提出 一 种 观念 : 代码 质量 与 其 整洁 度 成 正比 。 干 净 的 代码 ， 奴 
在 质量 上 较为 可 靠 ， 也 为 后 期 维护 、 升 级 左 定 了 民 好 基础 。 作 为 编程 领 
域 的 仪 仪 者， 本 书 作者 给 出 了 一 系列 行 之 有 效 的 整洁 代码 操作 实践 。 这 
些 实践 在 本 书 中 体现 为 一 条 条 规则 (或 称 “ 局 示 ”) ， 并 辅 以 来 自 现 实 项 
目的 正 、 反 两 面 的 范例 。 只 要 遵循 这 些 规 则 ， 就 能 编写 出 干净 的 代码 ， 
从 而 有 效 提升 代码 质量 。 

本 书 阅 读 对 象 为 一 切 有 志 于 改善 代码 质量 的 程序 员 及 技术 经 理 。 书 
中 介绍 的 规则 均 来 自作 者 多 年 的 实践 经 验 ， 涵 盖 从 命名 到 重 构 的 多 个 编 
程 方 钾 ， 昌 为 一 “家 ”之 言 ， 然 诚 有 可 资 借 鉴 的 价值 。 
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FI (Ga-Jol) 是 在 丹麦 最 受 欢 迎 的 糖果 品种 之 一 ， 它 浓郁 的 甘草 
味道 ， 完 美 地 弥补 了 此 地 潮湿 且 时 第 寒冷 的 天 气 。 对 于 我 们 这 些 丹 麦 
人 ， 乐 嚼 的 妙 处 还 在 于 包装 盒 项 上 印 制 的 哲 言 莫 语 。 今 早 我 买 了 一 包 两 
件 装 ， 在 其 包装 使 上 发 现 这 人 句 丹 麦 谚 语 : 

ZE rlighed i smd ting er ikke nogen lille ting. 

“小 处 诚实 非 小 事 。” 这 人 句 话 正好 是 我 想 在 这 里 说 的 。 以 小 见 大 。 本 
书写 到 了 一 些 价值 殊 胜 的 小 主题 。 

神 在 细节 之 中 ， 建 筑 师 Ludwig mies van der Rohe 〈 路 德 维 希 .密斯 
范 ' 德 . 罗 ) [1 如 是 说 。 这 人 句 话 引发 了 有 关 软 件 开发 、 特 别 是 敏捷 软件 开 
APSR AT Mb HALA FP. HF (Bob)〉[2I 和 我 时 常 发 现 自己 沉 酒 
于 此 类 对 话 中 。 没 错 ，Ludwig mies van der Rohe 的 确 专 注 于 效用 和 基于 
宏伟 架构 之 上 的 永恒 建筑 形式 。 然 而 ， 他 也 为 自己 设计 的 每 所 房屋 挑选 
每 个 门 把 手 。 为 什么 ?因为 小 处 见 大 。 

就 ”TDDI3] 话 题 展开 目前 仍 在 继续 的 “辩论 ”时 ， 鲍 劲 和 我 认识 到 ， 
我 们 均 同 意 软件 架构 在 开发 中 占据 重要 地 位 ， 但 就 其 确切 意义 而 言 ， 我 
们 之 间 还 有 分 卜 。 然 而 ， 这 种 巴 与 盾 训 利 的 讨论 相对 而 言 并 不 重要 ， 
为 在 项 目 开 始 之 时 ， 我 们 理所当然 应 该 让 专业 人 士 投 入 些许 时 间 去 思考 
及 规划 。20 世 纪 90 年 代 末 期 有 关 仅 以 测试 和 代码 驱动 设计 的 概念 已 一 去 
不 返 。 相 对 于 任何 宏伟 愿景 ， 对 细节 的 关注 甚至 是 更 为 天 键 的 专业 性 基 
础 。 首 先 ， 开 发 者 通过 小 型 实践 获得 可 用 于 大 型 实践 的 技能 和 信用 度 。 
其 次 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 关 不 紧 的 门 、 有 点 儿 没 铺 平 的 地 








板 ， 甚 至 是 次 乱 的 果 面 ， 都 会 将 整个 大 局 的 魅力 毁灭 驳斥 。 这 就 是 整洁 
代码 之 所 系 。 

架构 只 是 软件 开发 用 到 的 借 喻 之 一 ， 主 要 用 在 那 种 等 同 于 建筑 师 交 
付 毛坯 房 一 般 交 付 初始 软件 产品 的 场合 。 在 Scrum 和 敏捷 (Agile)〉 的 日 
子 里 ， 人 们 关注 的 是 快速 将 产品 推 同 市 场 。 我 们 要 求 工厂 全 速 运转 、 和 后 
产 软件 。 这 就 是 人 类 工厂 : 懂 思 考 、 会 感受 的 编码 人 ， 他 们 由 产品 备 瑟 
或 用 户 故 事 开 始 创造 产品 。 来 自制 造 业 的 借 喻 在 这 种 场合 大 行 其 道 。 例 
W, Scrum 就 从 装配 线 式 的 日 本 汽车 生产 方式 中 获 益 恨 多 。 

即便 是 在 汽车 工业 里 ， 大 量 工 作 也 并 不 在 于 生产 而 在 于 维护 一 一 或 
避免 维护 。 对 于 软件 而 言 ， 百 分 之 八 十 或 更 多 的 工作 量 集中 在 我 们 美 其 
名 日 “维护 ”的 事情 上 : 其 实 就 是 修 修补 补 。 与 其 接受 西方 关于 制造 好 软 
件 的 传统 看 法 ， 不 如 将 其 看 作 建 筑 工 业 中 的 房屋 修理 工 ， 或 者 汽车 领域 
的 汽 修 工 。 日 本 式 管理 对 于 这 种 事 怎 么 说 的 呢 ? 

大 约 在 1951 年 ， 一 种 名 为 “全 员 和 后 产 维护 ”(Total Productive 
Maintenance, TPM) 的 质量 保证 手段 在 日 本 出 现 。 它 关注 维护 其 于 关 
注 生产 。TPM 的 主要 支柱 之 一 是 所 谓 的 5S 原 则 体系 。5S 是 一 套 规 程 ， 

用 “规程 ”这 个 词 ， 是 为 了 读者 便于 理解 。5S 原 则 其 实 是 精益 (Lean) 
一 一 西方 视野 中 的 一 个 时 菊 词 ， 也 是 在 软件 领域 渐 领 风骚 的 时 晓 词 
的 基石 所 在 。 正 如 鲍 勃 大 叔 CUncle Bob) 在 前 言 中 写 到 的 ， 良 好 的 软 
件 实 践 遵循 这 些 规 程 ， 专注、 镇 定 和 思考 。 这 并 非 总 只 有 关 实 作 ， 有 关 
推动 工厂 设备 以 最 高 速度 运转 。5S 哲 学 包括 以 下 概念 : 

HFE (Seiri) [4]， 或 谓 组 织 〈 想 想 英 语 中 的 sort〈 分 类 、 排 序 ) 一 
词 ) 。 摘 清楚 事物 之 所 在 一 一 通过 恰当 地 命名 之 类 的 手段 一 一 全 关 重 
要 。 觉 得 命名 标识 无 关 紧 要 ? 读 读 后 面 的 章节 吧 。 

整顿 (Seiton) ， 或 谓 整 齐 〈 想 想 英 文中 的 systematize (系统 化 ) 
一 词 ) 。 有 名 美国 老话 说 : 物 篆 有 其 位 ， 而 后 物 尽 归 其 位 (A place for 
everything, and everything in its place) 。 每 段 代 码 都 该 在 你 希望 它 所 在 
































的 地 方 一 一 如 果 不 在 那里 ， 就 需要 重 构 了 。 

清楚 〈Seiso) ， 或 谓 清 洁 〈 想 想 英 文中 的 shine CER) 一 词 ) 。 
清理 工作 地 的 拉线 、 油 污 和 边 角 废 料 。 对 于 那 种 四 处 遗弃 的 融 注 释 的 代 
码 及 反映 过 往 或 期 望 的 无 注释 代码 ， 本 书 作 者 怎么 说 的 来 着 ? 除 之 而 后 
快 。 

清洁 (Seiketsu〉， 或 谓 标 准 化 。 有 关 如 何 保持 工作 地 清洁 的 组 内 
共识 。 本 书 有 没有 提 到 在 开发 组 内 使 用 一 贯 的 代码 风格 和 实践 手段 ?这 
些 标准 从 哪里 来 ? 读 读 看 。 

x (Shitsuke) [5]， 或 谓 纪 律 〈 自 律 )。 在 实践 中 贯彻 规程 ， 并 
时 时 体现 于 个 人 工作 上 ， 而 且 要 乐于 改进 。 

如 果 你 接受 挑战 一 一 没 错 ， 就 是 挑战 ， 阅 读 并 应 用 本 书 ， 你 就 会 理 
解 和 赞赏 上 述 最 后 一 条 。 我 们 最 终 是 在 驶 同一 种 负责 任 的 专业 精神 之 根 
源 所 在 ， 这 种 专业 性 隶属 于 一 个 关注 产品 生命 周期 的 专业 领域 。 在 我 们 
遵循 TPM 来 维护 机 动车 和 其 他 机 械 时 ， 停 机 维护 一 一 等 竺 缺陷 显现 出 
来 一 一 并 不 单 见 。 我 们 更 上 一 层 楼 : 每 天 检查 机 械 ， 在 磨损 机 件 停止 工 
作 之 前 就 换 掉 它 ， 或 者 按 常 例 每 1000 英 里 〈 约 1609.3km) 就 更 换 润 滑 
油 、 防 止 磨损 和 开裂 。 对 于 代码 ， 应 无 情 地 做 重 构 。 还 可 以 更 进一步 ， 
就 像 TPM 运 动 在 50 多 年 前 的 创新 : 一 开始 就 打造 更 易 维 护 的 机 械 。 写 出 
可 读 的 代码 ， 重 要 程度 不 亚 于 写 出 可 执行 的 代码 。1960 年 左右 ， 围 经 
TPM 引 入 的 终极 实践 Cultimate practice) ， 关 注 用 全 新 机 械 替 代 旧 机 
械 。 诚 如 Fred Brooks 所 言 ， 我 们 或 许 应 该 每 7 年 就 重 做 一 次 软件 的 主要 
模块 ， 清 理 缓慢 陈腐 的 代码 。 也 许 我 们 该 把 重 构 周 期 从 以 年 计 缩 短 到 以 
周 、 以 天 甚至 以 小 时 计 。 那 便 是 细节 所 在 了 。 

A PAAR, MEA PY AIRF RIBAK, BER 
我 们 一 成 不 变 地 对 那些 源 自 日 本 的 做 法 寄予 厚望 一 般 。 这 并 非 只 是 东方 
的 生活 观 ， 瑞 美 民间 也 过 是 这 类 警句 。 上 引 “ 整 顿 ”(Seiton) — 3L 
出 现在 某 位 俄 北 俄 州 牧 师 的 笔下 ， 他 把 齐整 看 作 是 “ 荡 潍 种 种 罪恶 之 良 


























Jj". “RE” (Seiso) 又 如 何 呢 ? AT PE (Cleanliness is next to 
godliness) 。 AMATE 所 丽 宅 的 光彩 。 老 话 怎么 
WAR” CShitsuke) 的 ? 守 小 节 者 不 亏 大 节 〈He who is faithful in little 
is faithful in much) 。 对 于 时 时 准备 在 恰当 时 机 做 重 构 ， 为 未 来 
的 “大 ” 扇 定 夯实 基础 ， 而 不 是 置 诸 脑 后 ， 有 什么 说 法 吗 ? 及 时 一 针 省 九 
F CA stitch in time saves nine) . ‘PHS JLA NZ (The early bird 
catches the worm) 。 日 事 日 毕 (Don’t put off until tomorrow what you can 
do today) 。 在 精益 实践 钞 入 软件 咨询 师 之 手 前 ， 这 束 是 其 所 谓 “ 最 后 时 
机 2 的 本 义 所 在 。 摆 正 单项 工作 在 整体 中 的 位 置 呢 ? E AZ FRI 
(Mighty oaks from little acorns grow) 。 如 何在 日 常生 活 中 做 好 简单 的 
防备 性 工作 呢 ? 防 病 好 过 治 病 (An ounce of prevention is worth a pound 
of cure) 。 一 天 一 笠 果 ， 医 生 远 离 我 (An apple a day keeps the doctor 
away) 。 整 洁 代 人 码 以 其 对 细节 的 关注 ， 菏 溜 了 深 埋 于 我 们 现 有 、 或 曾 
有 、 或 该 有 的 壮丽 文化 之 下 的 智 芒 根源 。 

即便 是 在 宏伟 的 建筑 作品 中 ， 我 们 也 上 听 到 关注 细节 的 回 啊 。 想 想 
Ludwig mies van der Rohe 的 门 把 手 吧 。 那 正 是 整理 CseirD 。 认 真 对 符 
每 个 变量 名 。 你 当 用 为 自己 第 一 个 孩子 命名 般 的 谍 慎 来 给 变量 命名 

正如 每 位 房 主 所 知 ， 此 类 照料 和 修 昔 永 无 休止 。 建 箔 na 
Alexander 一 一 模式 与 模式 语言 之 父 一 一 把 每 个 设计 动作 看 作 是 较 小 的 局 
部 修复 动作 。 他 认为 ， 设 计 民 好 结构 才 是 建筑 师 的 本 职 所 在 ， 而 更 大 的 
建筑 形态 则 当 留 给 模式 及 居住 者 搬 进 的 家 私 来 完成 。 设 计 始 终 在 持续 进 
行 ， 不 只 是 在 新 建 一 个 房间 时 ， 也 在 我 们 重新 粉刷 墙 面 、 更 换 旧 地 徐 或 
者 换 厨 房 水 槽 时。 大 多 数 艺 术 门 类 也 持 类 似 主张 。 在 寻找 其 他 推 尝 细节 
的 人 时 ， 我 们 发 现 ，19 世 纪 法 国 作 家 Gustav Flaubert 〈 古 斯 塔 夫 . 福 楼 
FE) ZO. YEA Paul Valery URI PU d EO 认为 ， 每 首 诗歌 都 
KSLH, GRZ, BEM AIE. 4cMBUET HS. BPE 
KUTA ZH. BRT eS, (Ab BEA ee De Pp 


























战 ， 你 要 重 拾 久 已 弃置 脑 后 的 展 好 规则 ， 目 发 自主 , “ 啊 应 改变 ”。 

不 幸 的 是 ， 我 们 往往 见 不 到 人 们 把 对 细 市 的 关注 当 作 编程 艺术 的 基 
础 要 件 。 我 们 过 早 地 放弃 了 在 代码 上 的 工作 ， 并 不 是 因为 它 业 已 完成 ， 
而 是 因为 我 们 的 价值 体系 关注 外 在 表现 其 于 关注 要 交付 之 物 的 本 质 。 芷 
忽 最 终结 出 了 恶果 : 坏 东 西 一 再 出 现 。 无 论 是 在 行业 里 还 是 学 术 领 域 ， 
研究 者 都 很 重视 代码 的 整洁 问题 。 供 职 于 贝尔 软件 生产 研究 实验 室 
(Bell Labs Software Production Research) 一 -一 没 错 ， 就 是 生产 ! 
时 ， 我 们 有 些 不 太 严 蜜 的 上 发现， 认为 前 后 一 致 的 缩 进 风 格 明 显 标志 了 较 
低 的 缺陷 率 。 我 们 原 指 望 将 质量 归 因 于 架构 、 编 程 语 言 或 者 其 他 高 级 概 
念 ; 我 们 的 专业 能 力 归 功 于 对 工具 的 掌握 和 各 种 高 高 在 上 的 设计 方法 ， 
至 于 那些 安置 于 三 区 的 机 器 ， 那 些 编码 者 ， 他 们 居然 通过 简单 地 保持 一 
致 缩 进 风格 创造 了 价值 ， 这 简直 是 一 种 侮辱 。 我 在 17 年 前 就 在 书 中 写 
过 ， 这 种 风格 远 不 止 是 一 种 单纯 的 能 力 那 么 简单 。 日 本 式 的 世界 观 深 知 
日 常 工 作者 的 人 价值， 而且， 还 深 知 工作 者 简单 的 日 常 行为 所 锻造 的 开发 
系统 的 价值 。 质 量 是 上 百 万 次 全 心 投 入 的 结果 一 一 而 非 仅 归功 于 任何 来 
自 天 等 的 伟大 方法 。 这 些 行 为 简单 却 不 简陋 ， 也 不 意味 着 简易 。 相 反 ， 
它们 是 人 力 所 能 达 的 不 仅 伟大 而 且 美 丽 的 造物 。 忽 略 它们 ， 束 不 成 其 为 
完整 的 人 。 

当然 ， 我 仍然 提倡 放宽 思路 ， 也 推 尝 根植 于 深厚 领域 知识 和 软件 可 
用 性 的 各 种 架构 手法 的 价值 。 但 本 书 与 此 无 关 一 一 人 至少， 没有 明显 关 
系 。 本 书 精妙 之 处 ， 其 意义 之 深远 ， 不 该 无 人 贰 识 。 它 正 与 Peter 
Sommerlad, Kevlin Henny 及 Giovanni Asproni 等 真正 写 代码 的 人 现今 所 
持 的 观念 相 吻 合 。 他 们 茧 吹 “ 代 码 即 设计 ?和 “简单 代码 ”。 我 们 要 讶 记 ， 
界面 就 是 程序 ， 而 且 其 结构 也 极 大 地 反映 出 程序 结构 ， 但 也 理应 始终 说 
还 地 承认 设计 存在 于 代码 中 ， 这 至 关 紧 要 。 制 造 上 的 返工 导致 成 本 上 
升 ， 但 重 做 设计 却 创 造 出 价值 。 我 们 应 当 视 代码 为 设计 一 一 作为 过 程 而 
非 终 点 的 设计 一 一 这 种 高 尚 行为 的 漂 腕 体现 。 粳 合 与 内 有 聚 的 架构 韵律 在 



























































代码 中 脉动 。Larry Constantine 以 代码 的 形式 而 不 是 用 UML 那 种 高 
高 在 上 的 抽象 概念 RIAA SAGE. Richard Garbriel 





fE“Abstraction Descant”( 抽 象 刍议 ) 一 文中 告诉 我 们 ， 抽 和 象 即 恶 。 代 码 
除 恶 ， 而 整洁 的 代码 则 大 抵 是 圣洁 的 。 

回 到 我 那个 小 小 的 乐 鄙 包装 盒 ， 我 想 要 重点 提 一 下 ， 那 句 丹 麦 谚 语 
不 只 是 教 我 们 重视 小 处 ， 更 教 我 们 小 处 要 诚实 。 这 意味 着 对 代码 诚实 、 
对 同僚 坦承 代码 现状 ， 最 重要 的 是 在 代码 问题 上 不 自 和 其。 是 否 已 尽 全 
力 “ 把 露营 地 清理 得 比 来 时 还 干净 ”? 签 入 代码 前 是 否 已 做 重 构 ? 这 可 不 
是 皮毛 小 事 ， 它 正高 甲 于 敏捷 价值 的 正中 位 置 。Scrum 有 一 种 建议 的 实 
践 ， 主 张 重 构 是 “完成 ”(Done) 概念 的 一 部 分 。 无 论 是 架构 还 是 代码 都 
PERKER, Rtas AM. AALT, HPA (To em is 
human; to forgive, divine) . fEScrum'H, FRE — Jn] I. RAME 
衣服 。 我 们 坦承 代码 状态 ， 因 为 它 永 不 完美 。 我 们 日 渐 成 为 完整 的 人 ， 
配 得 起 神 的 养 顾 ， 也 越 来 越 接近 细节 中 的 伟大 之 处 。 

在 自己 的 专业 领域 中 ， 我 们 号 需 能 得 到 的 一 切 帮 助 。 假 使 干净 的 地 
板 能 减少 事故 发 生 ， 假 使 归 置 到 位 的 工具 能 提升 生产 力 ， 我 也 会 倾 力 做 
到 。 人 至 于 本 书 ， 在 我 看 过 的 有 关 将 精益 原则 应 用 于 软件 的 印刷 品 中 ， 是 
最 具 实 用 性 的 。 那 班 求索 者 多 年 来 并 肩 奋 斗 ， 不 但 是 为 求 一 己 之 进步 ， 
更 将 他 们 的 知识 通过 和 你 手 上 正在 做 的 事 一 般 的 工作 贡献 给 这 个 行业 。 
看 过 鲍 勃 大 叔 寄 来 的 原稿 之 后 ， 我 发 现 ， 世 界 竟 略 有 改善 了 。 

对 高 瞻 远 瞩 的 练习 业已 结束 ， 我 要 去 清理 自己 的 书 和 更 了 。 

James O.Coplien T ZZ: SUR Ed 


























ULE: 20 地 纪 中 期 著名 现代 建筑 大 师 ， 秉 承 “ 少 即 是 多 ”的 建筑 设计 
哲学 ， 缔 造 了 玻璃 幕 增 等 现代 建筑 结构 。 


[21. 译 注 : 本 书 主 要 作者 Robert C. Martin 绰 号 Uncle Bob, ix HAY “tif 
Bh” KR SCH “fil KA Hi Et Robert C. Martin. 


[3].HE7E: Test Driven Development， 测 试 驱 动 开 发 。 
[AL PRE: 这 些 概念 最 初出 现 于 日 本 ，5 个 概念 的 日 文风 马 字 拼音 首 字 和 母 
正好 都 是 Ss， 所 以 这 里 也 保留 了 日 文 罗 马 字 拼 音 写 法 。 中 译本 以 日 文 汉 
字 直 接 译 出 ， 读 者 留意 ， 不 可 直接 对 应 其 中 文 意思 。 


[51. 译 注 : 中 文 意 为 “素养 、 教 养 ”。 














封面 的 图 片 是 M104: 草帽 星系 (The Sombrero Galaxy) . M1044% 
落 于 处 女 座 〈Virgo) ， 距 地 球 仅 3000 万 光 年 。 其 核心 是 一 个 质量 超大 
的 黑洞 ， 有 100 万 个 太阳 那么 重 。 

这 幅 图 是 否 让 你 想起 了 Klingon 星 球 ( 克 林 页 ) [LA Bg Praxis Gf 
拉 西 斯 ) 爆炸 的 事 ? 我 清楚 地 记得 ， 在 《 星 舰 迷航 VD FP, KREZ 
后 人 碎 厂 四 溅 ， 飞 舞 出 一 个 赤道 光环 的 场景 。 人 至 此 ， 光 环 就 成 为 科幻 电影 
中 爆炸 场景 的 必然 产物 了 。 甚 至 就 在 《 星 舰 迷航 》 系 列 电影 的 后 续 情 市 
中 ，Alderaan〔 阿 尔 德 然 〉 的 爆炸 也 有 类 似 场 景 出 现 。 

环绕 M104 的 光环 是 什么 造成 的 ? 它 为 何 会 有 如 此 巨大 的 脱 胀 京 和 
如 此 明亮 而 微小 的 内 核 ? 在 我 看 来 ， 仿 佛 那 位 于 中 心 位 置 的 黑洞 勃然 大 
Z, [RE RII HUUHUIEIB Y —7 7373 265E BR] — co EAF B 3 3d 
所 及 范围 之 内 的 居民 全 都 大 难 临 凑 了 。 

超大 质量 的 黑洞 以 星体 为 食 ， 将 星体 的 相当 部 分 质量 转换 为 能 量 。 
方程 式 E = MC“ 已 经 足够 体现 杠杆 作用 了 ， 但 当 M 有 一 颗 星体 那么 大 的 
质量 时 ， 看 吧 ! 在 那 巨 兽 酒 足 饭 饱 之 前 ， 有 多 少 星体 会 一 头 撞 进 它 的 骨 
里 ? 核心 部 分 空洞 的 大 小 ， 是 否 说 明了 些 什么 呢 ? 

封面 上 的 M104 图 乒 ， 是 用 来 自 于 哈 靳 望远镜 的 那 幅 著名 的 可 见 光 
相片 (上 图 ) 和 Spitzer( 斯 比 泽 〉 轨道 探测 器 最 新 的 红外 影像 (下 图 ) 
组 合 而 成 。 

在 红外 影像 中 ， 光 环 中 的 热 粒子 内 潍 着 穿 过 了 中 心 膨胀 体 。 这 两 幅 














烧 的 火海 。 

















封面 图 片 ， 来 自 斯 比 泽 太空 望远镜 





11. 系 列 剧 《 星 舰 迷 航 》 (Star Trek) 中 的 故事 情节 ，Praxis 星 爆炸 ， 由 
此 导致 联邦 和 Klingon 达 成 首次 和 平 协议 。 
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2007 年 3 月 ， 我 在 SD West ”2007 技术 大 会 上 聆听 了 Robert C. 
Martin (#07) ABO 的 主题 演讲 “Craftsmanship and the Problem of 
Productivity: Secrets for Going Fast without Making a Mess”。 一 身 休闲 打 
Joy AG A HSER KF at Code Monkey〔 代 码 猴子 ) 
开场 。 

是 的 ， 我 们 就 是 一 群 代码 猴子 ， 上 蹄 下 跳 ， 自 以 为 领略 了 编程 的 真 
谊 。 可 惜 ， 当 我 们 抓 着 几 个 酸 桃子 ， 得 意 洋洋 坐 到 树枝 上 ， 却 对 上 自己 造 
成 的 混乱 熟视无睹 。 那 堆 “ 可 以 运行 ”的 乱 砍 程序 ， 就 在 我 们 的 眼皮 底下 
慢 慢 腐 坏 。 

从 听 到 那 场 以 TDD 为 主题 的 演讲 之 后 ， 我 就 一 直 关 注 鲍 劲 大 叔 ， 还 
有 他 在 TDD 和 整洁 代码 方面 的 言论 。 去 年 ， 人 民 邮 电 出 版 社 计 算 机 分 社 
拿 一 本 书 给 我 看 ， 封 面 上 赫然 写 着 Robert C. Martin 的 大 名 。 看 完 原 书 序 
和 前 言 ， 我 已 经 按 探 不 住 ， 接 下 了 翻译 此 书 的 任务 。 这 本 书 名 为 Clean 
Code， 旋 是 Object Mentor( 鲍 勒 大 叔 开 办 的 技术 咨询 和 培训 公司 ) 一 干 
大 牛 在 编程 方面 的 经 验 累 积 。 按 鲍 勃 大 叔 的 话 来 说 ， 就 是 “Object 
Mentor 整 洁 代 码 派 ”的 说 明 。 

正如 Coplien 在 序 中 所 言 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 关 不 紧 
的 门 、 有 点 儿 没 铺 平 的 地 板 ， 甚 至 是 次 乱 的 更 面 ， 都 会 将 整个 大 局 的 魅 

毁灭 殖 尽 。 这 就 是 整洁 代码 之 所 系 。Coplien 列 举 了 许多 谚语 ， 证 明 整 
洁 的 价值 ， 中 国 也 有 修身 齐 家 治国 平 天 下 之 语 。 整 洁 代 码 的 重要 性 毋庸 
置疑 ， 问 题 是 如 何 写 出 真正 整洁 的 代码 。 











本 书 既 是 整洁 代码 的 定义 ， 亦 是 如 何 写 出 整洁 代码 的 指南 。 鲍 动 大 
叔 认 为 ,，“ 写 整洁 代码 ， 需 要 遵循 大 量 的 小 技巧 ， 贯 彻 刻 否 习 得 的 整洁 
感 *。 这 种 “代码 感 ' 就 是 关键 所 在 ..…. 它 不 仅 让 我 们 看 到 代码 的 优 劣 ， 还 
予 我 们 以 借 戒 规 之 力 化 劣 为 优 的 攻略 。” 作 者 前 述 了 在 命名 、 函 数 、 注 
释 、 代 码 格式 、 对 象 和 数据 结构 、 错 误 处 理 、 边 界 问题 、 单 元 测试 、 
类 、 系 统 、 并 发 编程 等 方面 如 何 做 到 整洁 的 经 验 与 最 佳 实 践 。 长 期 遵照 
这 些 经 验 编写 代码 ， 所 谓 “ 代 码 感 ” 也 就 自然 而 然 滋生 出 来 。 更 有 价值 的 
部 分 是 鲍 劳 大 叔 本 人 对 3 个 Java 项 目的 剖析 与 改进 过 程 的 实 操 记 录 。 通 
WKS ASHI Mids, BEAK FT HUE S ET Ze EES TES 
域 同样 适用 : 离开 时 要 比 发 现时 更 整洁 。 为 了 同 读 者 呈现 代码 的 原始 状 
态 ， 这 部 分 代码 及 本 书 其 他 部 分 的 绝 大 多 数 代 码 注 释 都 不 做 翻译 。 如 果 
读者 有 任何 疑问 ， 可 通过 邮件 与 我 沟通 (cleancode.cn@gmail.com) 。 

接触 开发 技术 十 多 年 以 来 ， 特 别 是 从 事 IT 技 术 媒 体 工作 六 年 以 来 ， 
我 见 过 许多 对 于 代码 整洁 性 缺乏 足够 重视 的 开发 者 。 不 算 过 分 地 说 ， 这 
是 职业 素养 与 基本 功 的 双重 缺陷 。 我 翻译 The Elements of C# Style CP 
译 版 《C# 编 程 风 格 》) 和 本 书 ， 实 在 也 是 希望 在 这 方面 看 到 开发 者 重视 
度 和 实际 应 用 的 提升 。 

在 本 书 的 结束 语 中 ， 鲍 动 大 叔 提 到 别人 给 他 的 一 条 腕 带 ， 上 面 的 字 
样 是 Test Obsessed 沉 迷 测 试 ) 。 鲍 劫 大叔 “发 现 自己 无 法 取 下 腕 带 。 不 
仪 是 因为 及 带 很 紧 ， 而 且 那 也 是 条 精神 上 的 紧 芳 嘻 。...... 它 一 直 提 醒 
我 ， 我 做 了 写 出 整洁 代码 的 承 话 。” 有 了 这 条 腕 和 市 ， 代 码 猴 子 成 了 模范 
童子 军 。 我 想 ， 每 位 开发 者 都 需要 这 样 一 条 腕 市 吧 ? 
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' WTFs MINUTE 


OF Code QUALIT 
衡量 代码 质量 的 唯一 有 效 标准 : WTF/min 





wt F 





BAA code. 





Good. code. 
7 Thom Holwerda $ fù, Éhttp://www.osnews.com/story/19266/WTFs_m 
再 制 





你 的 代码 在 哪 道 门 后 面 ? 你 的 团队 或 公司 在 哪 道 门 后 面 ? 为 什么 会 
在 那里 ? 只 是 一 次 普通 的 代码 复查 ， 还 是 产品 面世 后 才 发 现 一 连 串 严重 
问题 ? 我 们 是 否 在 战 战 殊 瑞 地 调试 自己 之 前 错 以 为 没 问 题 的 代码 ?客户 
是 否 在 流失 ? 经 理 们 是 否 把 我 们 有 盯 得 如 芒 刺 在 背 ? 当 事 态 变 得 严重 起 
来 ， 如 何 保证 我 们 在 那 道 正确 的 门 后 做 补救 工作 ? 答案 是 : 技艺 
(craftsmanship) 。 

习 艺 之 要 有 二 : 知 和 行 。 你 应 当 习 得 有 关 原 则 、 模 式 和 实践 的 知 
识 ， 穷 尽 应 知之 事 ， 并 且 要 对 其 了 如 指 掌 ， 通 过 刻 否 实践 掌握 它 。 

我 可 以 教 你 骑 自行 车 的 物理 学 原理 。 实 际 上 ， 经 典 数学 的 表达 方式 
相对 而 言 确实 简洁 明 了。 重力、 摩擦 力 、 角 动量 、 质 心 等 ， 用 一 页 写 满 
方程 式 的 纸 就 能 说 明白 。 有 了 这 些 方程 式 ， 我 可 以 为 你 证 明 出 骑 车 完全 
可 行 ， 而 且 还 可 以 告诉 你 骑 车 所 需 的 全 部 知识 。 即 便 如 此 ， 你 在 初次 骑 
车 时 还 是 会 跌倒 在 地 。 

编码 亦 同 此 理 。 我 们 可 以 写 下 整洁 代码 的 所 有 “感觉 民 好 ”的 原则 ， 
放手 让 你 去 干 〈 换 言 之， 让 你 从 自行 车 上 控 下 来 )。 那 样 的 话 ， 我 们 算 
是 哪 门 子 老师 ? 而 你 又 会 成 为 怎样 的 学 生 呢 ? 

不 ! 本 书 可 不 会 这 么 做 。 

学 写 整 洁 代 人 码 很 难 。 它 可 不 止 于 要 求 你 掌握 原则 和 模式 。 你 得 在 这 
上 上面 花 工夫 。 你 须 自 行 实 践 ， 且 体验 上 自己 的 失败 。 你 须 观 察 他 人 的 实践 
与 失败 。 你 须 看 看 别人 是 怎样 中 蹦 学 步 ， 再 转 头 研究 他 们 的 路 数 。 你 须 
看 看 别人 是 如 何 绞 尽 脑汁 做 出 决策 ， 又 是 如 何 为 错误 决策 付出 代价 。 

阅读 本 书 要 多 用 心思 。 这 可 不 是 那 种 降落 前 就 能 读 完 的 “感觉 不 
错 ? 的 飞机 书 。 本 书 要 让 你 用 功 ， 而 且 是 非常 用 功 。 如 何 用 功 ? 阅读 代 
码 一 一 大 量 代码 。 而 且 你 要 去 琢磨 茶 段 代码 好 在 什么 地 方 、 坏 在 什么 地 
方 。 在 我 们 分 解 ， 而 后 组 合 模块 时 ， 你 得 亦 步 亦 趋 地 跟 上 。 这 得 花 些 工 
夫 ， 不 过 值得 一 试 。 

本 书 大 致 可 分 为 3 个 部 分 。 前 几 章 介绍 编写 整洁 代码 的 原则 、 模 式 


























和 实践 。 这 部 分 有 相当 多 的 示例 代码 ， 读 起 来 颇具 挑战 性 。 读 完 这 几 
章 ， 就 为 阅读 第 2 部 分 做 好 了 准备 。 如 果 你 就 此 止步 ， 只 能 祝 你 好 运 
啦 ! 

第 2 部 分 最 需要 花 工 夫 。 这 部 分 包括 几 个 复杂 性 不 断 增加 的 案例 研 
究 。 每 个 案例 都 清理 一 些 代码 一 一 把 有 问题 的 代码 转化 为 问题 少 一 些 的 
代码 。 这 部 分 极为 详细 。 你 的 思维 要 在 讲解 和 代码 段 之 间 跳 来 跳 去 。 你 
得 分 析 和 理解 那些 代码 ， 琢 磨 每 次 修改 的 来 龙 去 脉 。 

你 付出 的 劳动 将 在 第 3 部 分 得 到 回报 。 这 部 分 只 有 一 章 ， 列 出 从 上 
述 案 例 研究 中 得 到 的 启示 和 灵感 。 在 遍 览 和 清理 案例 中 的 代码 时 ， 我 们 
把 每 个 操作 理由 记录 为 一 种 启示 或 灵感 。 我 们 尝试 去 理解 自己 对 阅读 和 
修改 代码 的 反应 ， 尽 力 了 解 为 什么 会 有 这 样 的 感受 、 为 什么 会 如 此 行 
事 。 结 果 得 到 了 一 套 描述 在 编号、 了 阅读、 清理 代码 时 思维 方式 的 知识 
库 。 

如 果 你 在 阅读 第 2 部 分 的 案例 研究 时 没有 好 好 用 功 ， 那 么 这 套 知识 
库 对 你 来 说 可 能 所 值 无 几 。 在 这 些 案 例 研 究 中 ， 每 次 修改 都 仔细 注 明 了 
相关 局 示 的 标号 。 这 些 标号 用 方 括号 标 出 ， 如 : [H22]。 由 此 你 可 以 看 
到 这 些 启示 在 何 种 环境 下 被 应 用 和 编写 。 启 示 本 里 不 值钱 ， 启 示 与 案例 
研究 中 清理 代码 的 具体 决策 之 间 的 关系 才 有 价值 。 

如 果 你 跳 过 案例 研究 部 分 ， 只 阅读 了 第 1 部 分 和 第 3 部 分 ， 那 就 不 过 
是 又 看 了 一 本 关于 写 出 好 软件 的 “感觉 不 错 ? 的 书 。 但 如 果 你 肯 花 时 间 琢 
磨 那 些 案 例 ， 亦 步 亦 趋 一 一 站 在 作者 的 角度 ， 迫 使 自己 以 作者 的 思维 路 
径 考 虑 问题 ， 就 能 更 深刻 地 理解 这 些 原则 、 模 式 、 实 践 和 启示 。 这 样 的 
话 ， 就 像 一 个 熟练 地 掌握 了 骑 车 的 技术 后 ， 自 行车 就 如 同 其 身体 的 延伸 
部 分 那样 ， 对 你 来 说 ， 本 书 所 介绍 的 整洁 代码 的 原则 、 模 式 、 实 践 和 启 
示 就 成 为 了 本 身 具有 的 技艺 ， 而 不 再 是 “感觉 不 错 ” 的 知识 。 
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阅读 本 书 有 两 种 原因 : 第 一 ， 你 是 个 程序 员 ; 第 二 ， 你 想 成 为 更 好 
的 程序 员 。 很 好 。 我 们 需要 更 好 的 程序 员 。 

这 是 本 有 关 编 写 好 程序 的 书 。 它 充斥 着 代码 。 我 们 要 从 各 个 方向 来 
考察 这 些 代 码 。 从 项 问 下 ， 从 底 往 上 ， 从 里 而 外 。 读 完 后 ， 就 能 知道 许 
多 关于 代码 的 事 了 。 而 且 ， 我 们 还 能 说 出 好 代码 和 粳 糕 的 代码 之 间 的 状 
异 。 我 们 将 了 解 到 如 何 写 出 好 代码 。 我 们 也 会 知道 ， 如 何 将 糟糕 的 代码 
改 成 好 代码 。 


























1.1 EA TIE 


有 人 也 许 会 以 为 ， 关 于 代码 的 书 有 点 儿 落 后 于 时 代 一 一 代码 不 再 是 
问题 ， 我 们 应 当 关 注 模 型 和 需求 。 确 实 ， 有 人 说 过 我 们 正在 临近 代码 的 
终结 点 。 很 快 ， 代 码 就 会 目 动 产生 出 来 ， 不 需要 再 人 工 编写 。 程 序 员 完 
全 没 用 了 ， 因 为 商务 人 士 可 以 从 规约 直接 生成 程序 。 

扯淡 ! 我 们 永远 抛 不 掉 代 码 ， 因 为 代码 呈现 了 需求 的 细节 。 在 东 些 
层面 上 ， 这 些 细 市 无 法 被 忽略 或 抽象 ， 必 须 明确 之 。 将 需求 明确 到 机 器 
可 以 执行 的 细 市 程度 ， 就 是 编程 要 做 的 事 。 而 这 种 规约 正 是 代码 。 

我 期 望 语言 的 抽象 程度 继续 提升 。 我 也 期 望 领域 特定 语言 的 数量 继 
续 增 加 。 那 会 是 好 事 一 桩 。 但 那 终结 不 了 代码 。 实 际 上 ， 在 较 高 层次 上 
用 领域 特定 语言 撰写 的 规约 也 将 是 代码 ! 它 也 得 严谨 、 精 确 、 规 范 和 详 
细 ， 好 让 机 器 理解 和 执行 。 

那 帮 以 为 代码 终 将 消失 的 伙计 ， 束 像 是 巴 望 着 发 现 一 种 无 规范 数学 
NASA ik. MOIRA, BARRIEMILES, RIR E 
想 想 、 嘴 都 不 用 张 束 能 叫 它 依 计 行 事 。 那 机 器 要 能 透彻 理解 我 们 ， 只 有 
这 样 ， 它 才能 把 含糊 不 清 的 需求 翻译 为 可 完美 执行 的 程序 ， 精 确 满足 需 
求 。 

这 种 事 永 远 不 会 发 生 。 即 便 是 人 类 ， 倾 其 全 部 的 直觉 和 创造 力 ， 也 
造 不 出 满足 客户 模糊 感觉 的 成 功 系 统 来 。 如 果 说 需求 规约 原则 教 给 了 我 
们 什么 ， 那 就 是 归 置 恨 好 的 需求 融 像 代码 一 样 正 式 ， 也 能 作为 代码 的 可 
执行 测试 来 使 用 。 

记 住 ， 代 码 确 然 是 我 们 最 终 用 来 表达 需求 的 那 种 语言 。 我 们 可 以 创 
造 各 种 与 需求 接近 的 语言 。 我 们 可 以 创造 帮助 把 需求 解析 和 汇 整 为 正式 


























结构 的 各 种 工具 。 然 而 ， 我 们 永远 无 法 抛弃 必要 的 精确 性 一 DARAI 
永存 。 


1.2 FEE ARA 


最 近 我 在 读 Kent Beck Implementation Patterns (中 译 版 《实现 模 
式 》) 四] 一 书 的 序言 。 他 这 样 写 道 : “..…. 本 书 基 于 一 种 不 太 牢 靠 的 前 
de: 好 代码 的 确 重 要 ......” 这 前 提 不 牢靠 ? 我 反对 ! 我 认为 这 是 该 领域 
最 强 固 、 最 受 文 持 、 最 被 强调 的 前 提 了 我 想 Kent 也 知道 ) 。 我 们 知道 
好 代码 重要 ， 是 因为 其 短缺 实在 困扰 了 我 们 太 久 。 

20 世纪 80 年 代 末 ， 有 家 公司 写 了 个 很 流行 的 杀手 应 用 ， 许 多 专业 
人 士 都 买 来 用 。 然 后 ， 发 布 周期 开始 拉 长 。 缺 陷 总 是 不 能 修复 。 装 载 时 
间 越 来 越久 ， 骨 省 的 几率 也 越 来 越 大 。 至 今 我 还 记得 自己 在 某 天 诅 形 地 
关 挥 那个 程序 ， 从 此 再 不 用 它 。 在 那 之 后 不 久 ， 该 公司 就 天 门 大 吉 了 。 




















20 年 后 ， 我 见 到 那 家 公司 的 一 位 早期 雇员 ， 问 他 当年 发 生 了 什么 
事 。 他 的 回答 叫 我 鳄 发 妨 惧 起 来 。 原 来 ， 当 时 他 们 赶 着 推出 产品 ， 代 码 
写 得 乱七八糟 。 特 性 越 加 越 多 ， 代 码 也 越 来 越 烂 ， 最 后 再 也 没 法 管理 这 
些 代码 了 。 是 糟 料 的 代码 毁 了 这 家 公司 。 

你 是 否 曾 为 糟糕 的 代码 所 深 深 困 扰 ? 如 果 你 是 位 有 点 儿 经 验 的 程序 
员 ， 定 然 多 次 遇 到 过 这 类 困境 。 我 们 有 专用 来 形容 这 事 的 词 :沼泽 
(wading) 。 我 们 趟 过 代码 的 水 域 。 我 们 穿 过 灌木 密布 、 瀑 布 暗 藏 的 沼 
译 地 。 我 们 拼命 想 找 到 出 路 ， 期 望 有 点 什么 线索 能 局 发 我 们 到 撒 发 生 了 
什么 事 ; 但 目光 所 及 ， 只 古越 来 越 多 死 气 沉沉 的 代码 。 




















你 当然 曾 为 糟糕 的 代码 所 困扰 过 。 那 么 一 一 为 什么 要 写 糟糕 的 代码 
We? 

是 想 快 点 完成 吗 ? 是 要 赶 时 间 吗 ? 有 可 能 。 或 许 你 觉得 自己 要 干 好 
所 需 的 时 间 不 够 ， 假使 花 时 间 清 理 代 码 ， 老 板 吉 会 大 发 雷霆。 或 许 你 只 
是 不 耐烦 再 搞 这 套 程 序 ， 期 望 早 点 结束 。 或 许 你 看 了 看 自己 承诺 要 做 的 
其 他 事 ， 意 识 到 得 赶紧 弄 完 手 上 的 东西 ， 好 接着 做 下 一 件 工作 。 这 种 事 
我 们 都 干 过 。 

我 们 都 曾经 盯 一 眼 自 己 杀 手 造成 的 混乱 ， 决 定 弃 之 而 不 顾 ， 走 向 新 
一 天 。 我 们 都 曾经 看 到 自己 的 烂 程序 居然 能 运行 ， 然 后 断言 能 运行 的 烂 
程序 总 比 什 么 都 没有 强 。 我 们 都 曾经 说 过 有 朝 一 日 再 回头 清理 。 当 然 ， 
在 那些 日 子 里 ， 我 们 都 没 听 过 勒 布朗 (LeBlanc) 法 则 : 稍 后 等 于 永 不 


(Later equals never) 。 
































1.3 混乱 的 代价 





只 要 你 干 过 两 三 年 编程 ， 就 有 可 能 曾 梓 东 人 的 糟糕 的 代码 绊 倒 过 。 
如 果 你 编程 不 止 两 三 年 ， 也 有 可 能 被 这 种 代码 拖 过 后 腿 。 进 度 延 组 的 程 
度 会 很 严重 。 有 些 团 队 在 项 目 初 期 进展 迅速 ， 但 有 那么 一 两 年 的 时 间 却 
慢 如 蜗 行 。 对 代码 的 每 次 修改 都 影响 到 其 他 两 三 处 代码 。 修 改 无 小 事 。 
每 次 添加 或 修改 代码 ， 都 得 对 那 扒 扭 纹 柴 了 然 于 心 ， 这 样 才能 往 上 扔 更 
多 的 扭 纹 染 。 这 团 乱 抹 越 来 越 大 ， 再 也 无 法 理 清 ， 最 后 束手无策 。 

随 看 混乱 的 增加 ， 团 队 生 产 力也 持续 下 降 ， 趋 同 于 和 零 。 当 生产 力 下 
降 时 ， 管 理 层 就 只 有 一 件 事 可 做 了 : 增加 更 多 人 手 到 项 目 中 ， 期 望 提 升 
生产 力 。 可 是 新 人 并 不 熟悉 系统 的 设计 。 他 们 搞 不 清楚 什么 样 的 修改 符 
合 设 计 意 图 ， 什 么 样 的 修改 违背 设计 意图 。 而 且 ， 他 们 以 及 团队 中 的 其 
他 人 部 背负 看 提升 生产 力 的 可 怕 压 力 。 于 是 ， 他 们 制造 更 多 的 混乱 ， 驱 
动 生产 力 回 零 那 端 不 断 下 降 。 如 图 1-1 所 示 。 

100 























80 





时 间 
图 1-1 生产 力 vs. 时 间 





最 后 ， 开 发 团队 造反 了 ， 他 们 告诉 管理 层 ， 再 也 无 法 在 这 令 人 生 厌 
的 代码 基础 上 做 开发 。 他 们 要 求 做 全 新 的 设计 。 管 理 层 不 愿意 投入 资源 
完全 重启 炉灶 ， 但 他 们 也 不 能 否认 和 生产力 低 得 可 怕 。 他 们 只 好 同意 开 友 
者 的 要 求 ， 授 权 去 做 一 套 看 上 去 很 美的 华丽 新 设计 。 

于 是 就 组 建 了 一 文 新 军 。 谁 都 想 加 入 这 个 团队 ， 因 为 它 是 张 白 纸 。 
他 们 可 以 重新 来 过 ， 搞 出 点 真正 漂亮 的 东西 来 。 但 只 有 最 优秀 、 最 聪明 
的 家 伙 被 选中 。 其 余人 等 则 继续 维护 现 有 系统 。 

现在 有 两 文 队 伍 在 竞赛 了 。 新 团队 必须 搭建 一 套 新 系统 ， 要 能 实现 
上 日 系统 的 所 有 功能 。 另 外 ， 还 得 跟 上 对 旧 系 统 的 持续 改动 。 在 新 系统 功 
能 足以 抗衡 昌 系 统 之 前 ， 管 理 层 不 会 蔡 换 掉 旧 系统 。 

苋 赛 可 能 会 持续 极 长 时 间 。 我 就 见 过 延续 了 十 年 之 久 的 。 到 了 完成 
的 时 候 ， 新 团队 的 老成 员 早 已 不 知 去 问 ， 而 现 有 成 员 则 要 求 重 新 设计 一 
套 新 系统 ， 因 为 这 套 系统 太 烂 了 。 

假使 你 经 历 过 哪怕 是 一 小 段 我 谈 到 的 这 种 事 ， 那 么 你 一 定 知 道 ， 花 
时 间 保 持 代 码 整洁 不 但 有 关 效 紊 ， 还 有 关 生 存 。 


1.3.2 态度 


你 是 否 遇 到 过 某 种 严重 到 要 花 数 个 星期 来 做 本 来 只 需 数 小 时 即 可 完 
成 的 事 的 混乱 状况 ? 你 是 否 见 过 本 来 只 需 做 一 行 修改 ， 结 果 却 涉及 上 百 
个 模块 的 情况 ? 这 种 事 太 常见 了 。 

怎么 会 发 生 这 种 事 ? 为 什么 好 代码 会 这 么 快 就 变质 成 糟糕 的 代码 ? 
理由 多 得 很 。 我 们 抱 候 需求 变化 背离 了 初期 设计 。 我 们 训 叹 进度 太 紧 
tk, iiA pi n8. BOE AGT AE RINZE, ARMAN. A 
用 的 营销 方式 和 那些 电话 消毒 剂 。 不 过 ， 亲 爱 的 呆 伯 特 (Dilbert) [2], 
我 们 是 自作 自 受 [3]。 我 们 太 不 专业 了 。 

这 话 可 不 太 中 听 。 人 怎么 会 是 自作 自 受 呢 ? 难道 不 关 需 求 的 事 ? 难道 




















不 关 进 度 的 事 ? ME ANE FS GE 2 BE ASA ERRE? 难道 他 们 
就 不 该 负 点 责 吗 ? 

不 。 经 理 和 营销 人 员 指望 从 我 们 这 里 得 到 必须 的 信息 ， 然 后 才能 做 
出 承诺 和 保证 ， 即 便 他 们 没 开 口 问 ， 我 们 也 不 该 着 于 告知 自己 的 想法 。 
用 户 指望 我 们 验证 需求 是 否 都 在 系统 中 实现 了 。 项 目 经 理 指望 我 们 遵守 
进度 。 我 们 与 项 目的 规划 脱 不 了 干系 ， 对 失败 负 有 极 大 的 责任 ; 特别 是 
当 失 败 与 糟糕 的 代码 有 关 时 尤为 如 此 ! 

“且慢 ! (Rit. “AUTEN, RSM. "SERA. SH 
经 理想 要 知道 实情 ， 即 便 他 们 看 起 来 不 喜欢 实情 。 多 数 经 理想 要 好 代 
码 ， 即 便 他 们 总 是 痴 缠 于 进度 。 他 们 会 奋力 卫 护 进度 和 需求 ， 那 是 他 们 
该 干 的 。 你 则 当 以 同等 的 热情 卫 护 代码 。 

再 说 明白 些 ， 假 使 你 是 位 医生 ， 病 人 请 求 你 在 给 他 做 手术 前 别 洗 
手 ， 因 为 那 会 花 太 多 时 间 ， 你 会 照办 吗 [4]? 本 该 是 病人 说 了 算 ; 但 医生 
却 绝对 应 该 拒绝 遵从 。 为 什么 ”因为 医生 比 病人 更 了 解 疾病 和 感染 的 风 
险 。 医 生 如 果 按 病人 说 的 办 ， 就 是 一 种 不 专业 的 态度 《更 别 说 是 犯罪 
Ta 

同 理 ， 程 序 员 遵从 不 了 解 混 乱 风险 的 经 理 的 意愿 ， 也 是 不 专业 的 做 
法 。 











1.3.3 E 


程序 员 面 临 着 一 种 基础 价值 谜 题 。 有 那么 几 年 经 验 的 开发 者 都 知 
道 ， 之 前 的 混乱 拖 了 自己 的 后 腿 。 但 开发 者 们 背负 期 限 的 压力 ， 只 好 制 
造 混乱 。 简 言 之 ， 他 们 没 花 时 间 让 自己 做 得 更 快 ! 真正 的 专业 人 士 明 
A, RR aba UU I. REVEAL ICH et DAHER. SÉSLA- 
立刻 拖 慢 你 ， 叫 你 错过 期 限 。 赶 上 期 限 的 唯一 方法 一 一 做 得 快 的 唯一 方 
法 一 一 就是 始终 尽 可 能 保持 代码 整洁 。 





1.3.4 整洁 代码 的 艺术 


假设 你 相信 温 乱 的 代码 是 祸首 ， 假 设 你 接受 做 得 快 的 唯一 方法 是 保 
持 代 码 整 洁 的 说 法 ， 你 一 定 会 自问 :“ 我 怎么 才能 写 出 整洁 的 代码 ? ”不 
过 ， 如 果 你 不 明白 整洁 对 代码 有 何 意 义 ， 演 试 去 写 整 洁 代 码 束 台 无 所 
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坏 消息 是 写 整 洁 代 码 很 像 是 绘画 。 多 数 人 都 知道 一 幅 画 是 好 还 是 
坏 。 但 能 分 辨 优 务 并 不 表示 懂得 绘画 。 能 分 辨 整洁 代码 和 肝脏 代码 ， 也 
不 意味 着 会 写 整洁 代码 ! 

写 整 洁 代 码 ， 需 要 遵循 大 量 的 小 技巧 ， 贯 彻 刻 百 习 得 的 “整洁 感 ”。 
这 种 “代码 感 ”就 是 关键 所 在 。 有 些 人 生 而 有 之 。 有 些 人 费 点 劲 才能 得 
到 。 它 不 仅 让 我 们 看 到 代码 的 优 务 ， 还 予 我 们 以 借 戒 规 之 力 化 劣 为 优 的 
攻略 。 

缺乏 “代码 感 ” 的 程序 员 ， 看 混乱 是 混乱 ， 无 处 着 手 。 有 “代码 感 ”的 
程序 员 能 从 混乱 中 看 出 其 他 的 可 能 与 变化 。“ 代 码 感 "帮助 程序 员 选 出 最 
好 的 方案 ， 并 指导 程序 员 制 订 修 改行 动 计 划 ， 按 图 过 村 。 

简 言 之 ， 编 写 整 清 代 码 的 程序 员 就 像 是 艺术 家 ， 他 能 用 一 系列 变换 
把 一 块 白 板 变 作 由 优雅 代码 构成 的 系统 。 


EX 




















1.3.5 什么 是 整洁 代 三 


有 多 少 程序 员 ， 就 有 多 少 定 义 。 所 以 我 只 询问 了 一 些 非常 知名 且 经 
验 丰富 的 程序 员 

Bjarne Stroustrup, C++ Ki, C++Programming 
Language (中 译 版 《C++ 程 序 设计 语言 》) 一 书 作者 。 

我 喜欢 优雅 和 高 效 的 代码 。 代 码 逻 辑 应 当 直 截 了 当 ， 岂 缺陷 难以 隐 
藏 ， 尺 量 减少 依赖 关系 ， 使 之 便于 维护 ;依据 某 种 分 层 战略 完善 错误 处 


o 


理 代码 ， 性 能 调 至 最 优 ， 省 得 引诱 别人 做 没 规矩 的 优化 ， 搞 出 一 堆 混 乱 
来 。 整 洁 的 代码 只 做 好 一 件 事 。 

Bjarne 用 了 “优雅 ”一 词 。 说 得 好 ! 我 MacBook 上 的 词典 提供 了 如 下 
定义 : 外 表 或 举止 上 令 人 愉悦 的 优美 和 雅 观 ; 令 人 愉悦 的 精致 和 简单 。 
注意 对 “愉悦 ”一 词 的 强调 。Bjarme 显 然 认 为 整洁 的 代码 读 起 来 令 人 愉 
悦 。 读 这 种 代码 ， 就 像 见 到 手工 精美 的 音乐 盒 或 者 设计 精良 的 汽车 一 
般 ， 让 你 会 心 一 笑 。 








Bjarne 也 提 到 效率 一 一 而 且 两 次 提 及 。 这 话 出 目 C++ 发 明 者 之 口 ， 
或 许 并 不 出 奇 ， 不 过 我 认为 并 非 是 在 单纯 奶 求 速度 。 被 浪费 掉 的 运算 周 
期 并 不 雅 观 ， 并 不 令 人 愉悦 。 留 意 Bjarne 怎么 描述 那 种 不 雅 观 的 结果 。 
他 用 了 “引诱 ”这 个 词 。 诚 哉 斯 言 。 粳 糙 的 代码 引发 混乱 ! 别人 修改 糟糕 
的 代码 时 ， 往 往 会 越 改 越 烂 。 

务实 的 Dave Thomas 和 Andy Hunt 从 另 一 角度 前 述 了 这 种 情况 。 他 们 
提 到 破 窗 理论 [5]。 窗 户 破损 了 的 建筑 让 人 觉得 似乎 无 人 照管 。 于 是 别人 
也 再 不 关心 。 他 们 放任 窗户 继续 破损 。 最 终 目 己 也 参加 破坏 活动 ， 在 外 
墙 上 深 鸦 ， 任 垃圾 堆积 。 一 届 破 损 的 窗户 开辟 了 大 厦 走 向 倾 笑 的 道路 。 

Bjarne 也 提 到 完善 错误 处 理 代 码 。 往 深 处 说 就 是 在 细节 上 人 花心 思 。 
敷衍 了 事 的 错误 处 理 代 码 只 是 程序 员 忽 视 细 节 的 一 种 表现 。 此 外 还 有 内 
存 泄漏 ， 还 有 兑 态 条 件 代 码 。 还 有 前 后 不 一 致 的 命名 方式 。 结 果 就 是 凸 
现 出 整洁 代码 对 细节 的 重视 。 

Bjarne 以 “整洁 的 代码 只 做 好 一 件 事 ”结束 论断 。 考 庸 置疑， 软件 设 
计 的 许多 原则 最 终 都 会 归结 为 这 人 句 警 语 。 有 那么 多 人 发表 过 类 似 的 言 
论 。 粳 糕 的 代码 想 做 太 多 事 ， 它 意图 混乱 、 目 的 含混 。 整 洁 的 代码 力求 
集中 。 每 个 函数 、 每 个 类 和 每 个 模块 者 全神贯注 于 一 事 ， 完 全 不 受 四 周 
细节 的 干扰 和 污染 。 

Grady Booch, Object Oriented Analysis and Design with 
Applications( 中 译 版 《 面 同 对 象 分 析 与 设计 》) 一 书 作 者 。 

整洁 的 代码 简单 直接 。 整 洁 的 代码 如 同 优美 的 散文 。 整 洁 的 代码 从 
不 隐藏 设计 者 的 意图 ， 充 满 了 干净 利落 的 抽象 和 直截了当 的 控制 语句 。 




















Grady 的 观点 与 “Bjarme 的 观点 有 类 似 之 处 ， 但 他 从 可 读 性 的 角度 来 
定义 。 我 特别 喜欢 “整洁 的 代码 如 同 优 美的 散文 ”这 种 看 法 。 想 想 你 读 过 
的 某 本 好 书 。 回 忆 一 下 ， 那 些 文字 是 如 何在 脑 中 形成 影像 ! 就 像 是 看 了 
场 电 影 ， 对 吧 ? 还 不 止 ! 你 还 看 到 那些 人 物 ， 听 到 那些 声 首 ， 体 验 到 那 

阅读 整洁 的 代码 和 阅读 Lord of the Rings (中 译 版 《指环 王 》) 自然 
不 同 。 不 过 ， 仍 有 可 类 比 之 处 。 如 同一 本 好 的 小 说 般 ， 整 洁 的 代码 应 当 
明确 地 展现 出 要 解决 问题 的 张力 。 它 应 当 将 这 种 张力 推 至 高 潮 ， 以 某 种 
显而易见 的 方案 解决 问题 和 张力 ， 使 读者 发 出 “ 啊 哈 ! 本 当 如 此 ! ”的 感 








叹 。 

$i UL 7jGrady Pris “FA tH AR” Ccrisp abstraction) ， 旋 是 绝妙 
AEREA. "ÉYécrisp)L-P-3k e "HU" (concrete) 的 同义词 。 我 
MacBook 上 的 词典 这 样 定义 crisp 一 词 : RR, MER, RAME 
或 不 必要 的 细节 。 尽 管 有 两 种 不 同 的 定义 ， 该 词 还 是 承载 了 有 力 的 信 
轧 。 代 码 应 当 讲 述 事实 ， 不 引 人 猜 测 。 它 只 该 包含 必需 之 物 。 读 者 应 当 
感受 到 我 们 的 果断 诀 绝 。 

“老大 ”Dave Thomas，OTI 公 司 创 始 人 ，Eclipse 战 略 教 父 。 

整洁 的 代码 应 可 由 作者 之 外 的 开 友 者 阅读 和 增补 。 它 应 当 有 单元 测 
试 和 验收 测试 。 它 使 用 有 意义 的 命名 。 它 只 提供 一 种 而 非 多 种 做 一 件 事 
的 途径 。 它 只 有 尽量 少 的 依赖 关系 ， 而 且 要 明确 地 定义 和 提供 清晰 、 尽 
量 少 的 API。 代 码 应 通过 其 字面 表达 含义 ， 因 为 不 同 的 语言 导致 并 非 所 
有 必需 信息 均 可 通过 代码 自身 清晰 表达 。 




















Dave 老 大 在 可 读 性 上 和 Grady 持 相同 观点 ， 但 有 一 个 重要 的 不 同 之 
处 。Dave 断 言 ， 整 洁 的 代码 便于 其 他 人 加 以 增补 。 这 看 似 显 而 易 见 ， 但 
亦 不 可 过 分 强调 。 毕 竟 易 读 的 代码 和 易 修 改 的 代码 之 间 还 是 有 区 别 的 。 

Dave 将 整洁 系 于 测试 之 上 ! 要 在 十 年 之 前 ， 这 会 让 人 大 跌 眼 锐 。 但 
测试 驱动 开发 (Test Driven Development) 已 在 行业 中 造成 了 深远 影 
响 ， 成 为 基础 规程 之 一 。Dave 说 得 对 。 没 有 测试 的 代码 不 干净 。 不 管 它 








有 多 优雅 ， 不 管 有 多 可 读 、 多 易 理 解 ， 微 乎 测试 ， 其 不 洁 亦 可 知 也 。 

Dave “两 次 提 及 “尽量 少 ”。 显 然 ， 他 推 委 小 块 的 代码 。 实 际 上 ， 从 
有 软件 起 人 们 就 在 反复 强调 这 一 点 。 越 小 越 好 。 

Dave 也 提 到 ， 代 人 码 应 在 字面 上 表达 其 含义 。 这 一 观点 源 自 Knuth 
的 “字面 编程 ”(literate programming) [6]。 结 论 就 是 应 当 用 人 类 可 读 的 
TAR SAN 

Michael Feathers, Working Effectively with Legacy Code (中 译 版 
《修改 代码 的 艺术 》) 一 书 作者 。 

我 可 以 列 出 我 留意 到 的 整洁 代码 的 所 有 特点 ， 但 其 中 有 一 条 是 根本 
性 的 。 整 洁 的 代码 总 是 看 起 来 像 是 某 位 特别 在 意 它 的 人 写 的 。 几 平 没有 
改进 的 余地 。 代 码 作者 什么 都 想到 了 ， 如 采 你 企图 改进 它 ， 总 会 回 到 原 
点 ， 赞 叹 某 人 留 给 你 的 代码 一 一 全 心 投入 的 某 人 留 下 的 代码 。 











EUZ: 在 意 。 这 就 是 本 书 的 题 则 所 在 。 或 许 该 加 个 副标题 ， 
如 何在 意 代码 。 

Michael 一 针 见 血 。 整 洁 代 码 束 是 作者 着 力 照料 的 代码 。 有 人 曾 花 
时 间 让 它 保 持 简 单 有 序 。 他 们 适当 地 关注 到 了 细节 。 他 们 在 意 过 。 


Ron Jeffries, Extreme Programming Installed (中 译 版 《极限 编 

程 实施 》) 以 及 Extreme Programming Adventures in C£ CH Ek 
《C# 极 限 编程 探险 》) 作者 。 

Ron 和 初 入 行 就 在 战略 空军 司令 部 (Strategic Air Command) 编写 
Fortran 程序 ， 此 后 几乎 在 每 种 机 器 上 编写 过 每 种 语言 的 代码 。 他 的 言论 
值得 咀嚼 。 

近年 来 ， 我 开始 研究 贝克 的 简单 代码 规则 ， 差 不 多 也 都 琢 麻 透 了 。 
简单 代码 ， 依 其 重要 顺序 : 








能 通过 所 有 测试 ; 

没有 重复 代码 ; 

体现 系统 中 的 全 部 设计 理念 ; 
包括 尽量 少 的 实体 ， 比 如 类 、 方 法 、 函 数 等 。 





在 以 上 诸 项 中 ， 我 最 在 意 代码 重复 。 如 果 同 一 段 代码 反复 出 现 ， 就 
表示 某 种 想法 未 在 代码 中 得 到 良好 的 体现 。 我 尽力 去 找 出 到 底 那 是 什 


么 ， 然 后 再 尽力 更 清晰 地 表达 出 来 。 

在 我 看 来 ， 有 意义 的 命名 是 体现 表达 力 的 一 种 方式 ， 我 往往 会 修改 
好 几 次 才 会 定 下 名 字 来 。 借 助 Eclipse 这 样 的 现代 编码 工具 ， 重 命名 代价 
极 低 ， 所 以 我 无 所 顾忌 。 然 而 ， 表 达 力 还 不 只 体现 在 命名 上 。 我 也 会 检 
答对 象 或 方法 是 否 想 做 的 事 太 多 。 如 果 对 象 功 能 太 多 ， 最 好 是 切 分 为 两 
个 或 多 个 对 象 。 如 果 方 法 功能 太 多 ， 我 总 是 使 用 抽取 手段 (Extract 
Method) 重 构 之 ， 从 而 得 到 一 个 能 较为 清晰 地 说 明 上 自身 功能 的 方法 ， 以 
及 另外 数 个 说 明 如 何 实现 这 些 功能 的 方法 。 

消除 重复 和 提高 表达 力 让 我 在 整洁 代码 方面 获 益 民 多 ， 只 要 铭记 这 
两 点 ， 改 进 脏 代码 时 就 会 大 有 不 同 。 不 过 ， 我 时 第 关注 的 另 一 规则 就 不 
太 好 解释 了 。 

这 么 多 年 下 来 ， 我 发 现 所 有 程序 都 由 极为 相似 的 元 又 构成 。 例 
如 “在 集合 中 碍 找 某 物 ”。 不 管 是 雇员 记录 数据 库 还 是 名 - 值 对 哈 希 表 ， 
或 者 某 类 条 目的 数组 ， 我 们 都 会 发 现 自己 想 要 从 集合 中 找到 某 一 特定 条 
目 。 一 旦 出 现 这 种 情况 ， 我 通常 会 把 实现 手段 封装 到 更 抽象 的 方法 或 类 
中 。 这 样 做 好 处 多 多 。 

可 以 先 用 某 种 简单 的 手段 ， 比 如 哈 希 表 来 实现 这 一 功能 ， 由 于 对 搜 
索 功 能 的 引用 指 回 了 我 那个 小 小 的 抽象 ， 就 能 随 需 应 变 ， 修 改 实现 手 
段 。 这 样 就 既 能 快速 前 进 ， 又 能 为 未 来 的 修改 预 留 余地 。 

男 外 ， 该 集合 抽象 常常 提醒 我 留意 “真正 ”在 发 生 的 事 ， 避 人 免 随 意 实 
现 集合 行为 ， 因 为 我 真正 需要 的 不 过 是 某 种 简单 的 查找 手段 。 

减少 重复 代码 ， 提 高 表达 力 ， 提 早 构建 简单 抽象 。 这 就 是 我 写 整 洁 
代码 的 方法 。 

Ron DAE SAO EME SABINA AA. BERS, KA 
一 件 事 ， 表 达 力 ， 小 规模 抽象 。 该 有 的 都 有 了 。 

Ward Cunningham，Wiki 发 明 者 ，eXtreme Programming (极限 
编程 》 的 创始 人 之 一 ，Smalltalk 语 言 和 面 同 对 象 的 思想 领袖 。 所 有 在 






































意 代码 者 的 教父 。 

如 果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 整洁 代码 。 如 果 代 码 让 
编程 语言 看 起 来 像 是 专 为 解决 那个 问题 而 存在 ， 就 可 以 称 之 为 漂亮 的 代 
码 。 











这 种 说 法 很 Ward。 它 教 你 听 了 之 后 就 点 头 ， 然 后 继续 听 下 去 。 如 
此 在 理 ， 如 此 浅显 ， 绝 不 故 作 高 深 。 你 大 概 以 为 此 言 深 合 己 意 吧 。 再 走 











«RE? 你 最 近 一 次 看 到 深 合 己 意 的 模块 是 什么 时 候 ? S 
块 多 半 都 繁复 难 解 吧 ? 难道 没有 触犯 规则 吗 ? 你 不 是 也 曾 挣扎 着 想 抓 住 
些 从 整个 系统 中 散落 而 出 的 线索 ， 编 织 进 你 在 读 的 那个 模块 吗 ? 你 最 近 
一 次 读 到 某 段 代码 、 并 且 如 同 对 Ward 的 说 法 点 头 一般 对 这 段 代 码 点 
头 ， 是 什么 时 候 的 事 了 ? 

Ward 期 望 你 不 会 为 整洁 代码 所 宕 尺 。 你 无 需 花 太 多 力气 。 那 代码 
就 是 深 合 你 意 。 它 明确 、 简 单 、 有 力 。 每 个 模块 都 为 下 一 个 模块 做 好 准 
备 。 每 个 模块 部 告诉 你 下 一 个 模块 会 是 怎样 的 。 整 洁 的 程序 好 到 你 根本 
不 会 注意 到 它 。 设 计 者 把 它 做 得 像 一 切 其 他 设计 般 简 单 。 

BS Ward ARR’ HDS Cone? 我 们 都 曾 面 临 语言 不 是 为 要 解 
决 的 问题 所 设计 的 困境 。 但 ”Ward 的 说 法 又 把 球 踢 回 我 们 这 边 。 他 说 ， 
漆 亮 的 代码 让 编程 语言 像 是 专 为 解决 那个 问题 而 存在 ! 所 以 ， 让 语言 变 
得 简单 的 责任 就 在 我 们 身上 了 ! 4b, WAEREA! 是 程序 员 让 


,五 二 EZB 
语言 显得 简单 。 














1.4 思想 流 ; 
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R MAKRI 又 是 怎么 想 的 呢 ? 在 我 眼中 整洁 代码 是 什么 样 的 ? 
本 书 将 以 详细 到 吓 死 人 的 程度 告诉 你 ， 我 和 我 的 同道 对 整洁 代码 的 看 
法 。 我 们 会 告诉 你 关于 整洁 变量 名 的 想法 ， 关 于 整洁 函数 的 想法 ， 关 于 
整洁 类 的 想法 ， 如 此 等 等 。 我 们 视 这 些 观点 为 当然 ， 且 不 为 其 逆 耳 而 致 
娄 。 对 我 们 而 言 ， 在 职业 生涯 的 这 个 阶段 ， 这 些 观 点 确 属 当然 ， 也 是 我 
Ea TIRE RE 








武术 家 从 不 认同 所 谓 最 好 的 武术 ， 也 不 认同 所 谓 绝招 。 武 术 大 师 们 
常常 创建 自己 的 流派 ， 聚 徒 而 授 。 因 此 我 们 才 看 到 格雷 西 家 族 在 巴西 开 
创 并 传授 的 格雷 西 柔 术 (Gracie Jiu Jistu) ， 看 到 奥 山 龙 峰 (Okuyama 
Ryuho) 在 东京 开创 并 传授 的 八 光 流 柔 术 (Hakkoryu Jiu Jistu) ， 看 到 李 
小 龙 (Bruce Lee) 在 美国 开创 并 传授 的 截 拳 道 (Jeet Kune Do) 。 

第 子 们 沉浸 于 创始 人 的 授 业 。 他 们 全 心 师 从 某 位 师 健 ， 排 斥 其 他 师 
f&. BPA BA, WOR Ae, TEA CW ARS RHE. 


有 些 弟 子 最 终 百 炼 成 钢 ， 创 出 新 招数 ， 开 宗 立 派 。 

任何 门派 都 并 非 绝 对 正确 。 不 过 ， 刁 处 某 一 门派 时 ， 我 们 总 以 其 所 
传 之 技 为 善 。 归 根 结 底 ， 练 习 八 光 流 柔 术 或 截 拳 道 ， 自 有 其 善 法 ， 但 这 
并 不 能 否定 其 他 门派 所 授 之 法 。 

可 以 把 本 书 看 作 是 对 象 导 师 (Object Mentor) [7] 整 洁 代 码 派 的 说 
明 。 里 面 要 传授 的 就 是 我 们 勤 操 己 艺 的 方法 。 如 果 你 遵从 这 些 教诲 ， 你 
就 会 如 我 们 一 般 乐 受 其 益 ， 你 将 学 会 如 何 编写 整洁 而 专业 的 代码 。 但 无 
论 如 何 也 别 错 以 为 我 们 是 “正确 的 "。 其 他 门派 和 师傅 和 我 们 一 样 专业 。 
你 有 必要 也 同 他 们 学 习 。 

实际 上 ， 书 中 很 多 建议 都 存在 争议 。 或 许 你 并 不 完全 同意 这 些 建 
议 。 你 可 能 会 强烈 反对 其 中 一 些 建 议 。 这 样 插 好 的 。 我 们 不 能 要 求 做 最 
终 权 威 。 男 外 一 方面 ， 书 中 列 出 的 建议 ， 乃 是 我 们 长 久 否 思 、 从 数 十 年 
的 从 业经 验 和 无 数 尝试 与 错误 中 得 来 。 无 论 你 同意 与 否 ， 如 果 你 没 看 到 
NED BET LA, RAZA OSH. 














1.5 我 们 十 


Javadoc 中 的 @author 字 段 告 诉 我 们 自己 是 什么 人 。 我 们 是 作者 。 作 
者 都 有 读者 。 实 际 上 ， 作 者 有 责任 与 读者 做 良好 沟通 。 下 次 你 写 代 码 的 
时 候 ， 记 得 自己 是 作者 ， 要 为 评判 你 工作 的 读者 写 代码 。 

你 或 许 会 问 : 代码 真正 * 读 ”的 成 分 有 多 少 呢 ? 难道 力量 主要 不 是 用 
(E«tj" png? 

你 是 否 玩 过 “编辑 器 回放 ”? 20 世 纪 80、90 年 代 ，Emac 之 类 编辑 器 记 
录 每 次 击 键 动作 。 你 可 以 在 一 小 时 工作 之 后 ， 回 放 击 键 过 程 ， 就 像 是 看 
一 部 高 速 电影 。 我 这 么 做 过 ， 结 果 很 有 趣 。 

回放 过 程 显示 ， 多 数 时 间 都 是 在 滚动 屏幕 、 浏 览 其 他 模块 ! 

鲍 勃 进入 模块 。 

他 向 下 滚动 到 要 修改 的 函数 。 

他 停 下 来 考虑 可 以 做 什么 

Hx, (RSS RET, RARE. 

现在 他 回 到 修改 处 ， 开 始 键入 。 

We, fh Pet T BEAR A A 

他 重新 键入 。 

他 又 删除 了 ! 

他 键入 了 一 半 什 么 东西 ， 又 删除 掉 。 

他 滚动 到 调用 要 修改 函数 的 另 一 函数 ， 看 看 是 怎么 调用 的 。 

他 回 到 修改 处 ， 重 新 键入 刚才 删 掉 的 代码 。 

他 停 下 来 。 

他 再 一 次 删 掉 代码 ! 
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他 打开 为 一 个 窗口 ， 但 看 别 的 子 类 。 那 古 个 复 载 函 数 吗 ? 

你 该 明白 了 。 读 与 写 花 费时 间 的 比例 超过 10:1。 写 新 代码 时 ， 我 们 
一 直 在 读 旧 代码 。 

既然 比例 如 此 之 高 ， 我 们 就 想 让 读 的 过 程 变 得 轻松 ， 即 便 那 会 使 得 
编写 过 程 更 难 。 没 可 能 光 写 不 读 ， 所 以 使 之 易 读 实际 也 使 之 易 写 。 

这 事 概 无 例外 。 不 读 周 边 代 码 的 话 就 没 法 写 代 码 。 编 写 代码 的 难 
度 ， 取 决 于 读 周 边 代 码 的 难度 。 要 想 干 得 快 ， 要 想 早点 做 完 ， 要 想 轻 松 
写 代 码 ， 先 让 代码 易 读 吧 。 


RA 


1.6 章 


光 把 代码 写 好 可 不 够 。 必 须 时 时 保持 代码 整洁 。 我 们 都 见 过 代码 随 
时 间 流 挝 而 腐 坏 。 我 们 应 当 更 积极 地 阻止 腐 坏 的 发 生 。 

借用 美国 童子 军 一 条 简单 的 军 规 ， 应 用 到 我 们 的 专业 领域 : 

让 营地 比 你 来 时 更 干净 。[8] 

如 果 每 次 签 入 时 ， 代 码 都 比 签 出 时 干净 ， 那 么 代码 就 不 会 腐 坏 。 清 
理 并 不 一 定 要 花 多 少 功 夫 ， 也 许 只 是 改 好 一 个 变量 名 ， 拆 分 一 个 有 点 过 
KA, HERR AERIS, ELM Bi. 

你 想 要 为 一 个 代码 随时 间 流 逝 而 越 变 越 好 的 项 目 工作 吗 ? 你 还 能 相 
信 有 其 他 更 专业 的 做 法 吗 ? 难道 持续 改进 不 是 专业 性 的 内 在 组 成 部 分 
吗 ? 








从 许多 角度 看 ， 本 书 都 是 我 ”2002 #55 Agile Software 
Development: Principles, Patterns, and Practices (中 译 版 《敏捷 软件 开 
R: 原则 、 模 式 与 实践 》， 简 称 PPP〉 的 “前 传 "。PPP 关 注 面 向 对 象 设 
计 的 原则 ， 以 及 专业 开发 者 采用 的 许多 实践 方法 。 假 如 你 没 读 过 PPP, 
你 会 发 现 它 像 这 本 书 的 延续 。 如 果 你 读 过 ， 会 发 现 那 本 书 的 主张 在 代码 
层面 于 本 书 中 回 啊 。 

在 本 书 中 ， 你 会 发 现 对 不 同 设计 原则 的 引用 ， 包 括 单一 权 贡 原则 

(Single Responsibility Principle, SRP) 、 开 放 闭 合 原则 (Open Closed 
Principle, OCP) 和 依赖 倒置 原则 (Dependency Inversion Principle, 
DIP) 等 。 








1.8 ^ zi 


艺术 书 并 不 保证 你 读 过 之 后 能 成 为 艺术 家 ， 只 能 告诉 你 其 他 亏 术 家 
用 过 的 工具 、 技 术 和 思维 过 程 。 本 书 同样 也 不 担保 让 你 成 为 好 程序 员 。 
它 不 担保 能 给 你 “代码 感 ”。 它 所 能 做 的 ， 只 是 展示 好 程序 员 的 思维 过 
程 ， 还 有 他 们 使 用 的 技巧 、 技 术 和 工具 。 

和 艺术 书 一 样 ， 本 书 也 充满 了 细节 。 代 码 会 很 多 。 你 会 看 到 好 代 
码 ， 也 会 看 到 精 糕 的 代码 。 你 会 看 到 粳 糕 的 代码 如 何 转化 为 好 代码 。 你 
会 看 到 启发 、 规 条 和 技巧 的 列表 。 你 会 看 到 一 个 又 一 个 例子 。 但 最 终结 
果 取 决 于 你 上 自己。 

还 记得 那个 关于 小 提 到 家 在 去 表演 的 路 上 迷路 的 老 笑 话 吗 ? 他 在 街 
角 拦 住 一 位 长 者 ， 问 他 怎么 才能 去 卡耐基 音乐 厅 〈Carnegie Hall) . 长 
者 看 了 看 小 提 蕉 家 ， 又 看 了 看 他 手中 的 和 ， 说 道 : “PRIA, AT, 


还 得 练 ! ” 
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1.9 


[Beck07]: Implementation Patterns,Kent Beck,Addison-Wesley,2007. 

[Knuth92]: Literate Programming, Donald E. Knuth, Center for the 
Study of Language and Information, Leland Stanford Junior University, 
1992. 





[1]. 原 注 : [Beck07]。 

[21. 译 注 : 车 名 IT 讽刺 漫画 。 

[31. 译 注 : 原文 为 But the fault, dear Dilbert, is not in our stars, but in 
ourselves. Jx HA A EH ERE (3S8 7JHr- DUO 98 — 5925 — AE 
台词 The fault, dear Brutus, is not in our stars, but in ourselves, that we are 


underlings. Cr BN St A rtl, ZIE, ARIE RAND E, 


不 能 怪罪 命运 。) 


[4]1. 原 注 : 1847 年 Ignaz Semmelweis (FN SER REM) 提出 医生 应 
洗手 的 建议 时 ， 遭 到 了 上 反对， 人 们 认为 医生 太 忙 ， 接 诊 时 无 暇 洗手 。 


[51]. 原 注 : http://www.pragmaticprogrammer.com/booksellers/2004- 
12.html. 


[6]./H 3X: [Knuth92]. 
(ZL. EYE: 本 书 主要 作者 Robert C.Martin 开 办 的 技术 咨询 和 培训 公司 。 


[81. 原 注 : 摘自 Robert Stephenson Smyth Baden-Powell( 英 国人， 童子 军 
创始 者 〉》 对 童子 军 的 遗言 “努力 ， 让 世界 比 你 来 时 干净 些 ..…...” 


Tim Ottinger 
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PPMP READ UMA. RIESE RA, BR, AM MA > 
我 们 给 源 代 码 及 源 代 码 所 在 目录 命名 。 我 们 给 jar 文 件 、war 文 件 和 ear 文 
件 命名 。 我 们 命名 、 命 名 ， 不 断 命 名 。 既 然 有 这 么 多 命名 要 做 ， 不 妨 做 
好 它 。 下 文 列 出 了 取 个 好 名 字 的 几 条 简单 规则 。 


2.2 名 副 其 实 


副 其 实说 起 来 简单 。 我 们 想 要 强调 ， 这 事 很 严肃 。 选 个 好 名 字 要 

化 时 间 ， 但 省 下 来 的 时 间 比 花 挥 的 多 。 注 意 命名 ， 而 且 一 旦 发 现 有 更 好 
的 名 称 ， 就 换 邱 旧 的 。 这 么 做 ， 读 你 代码 的 人 《包括 你 目 己 ) 都 会 更 开 
心 。 

变量 、 函 数 或 类 的 名 称 应 该 已 经 答复 了 所 有 的 大 问题 。 它 该 告诉 
你 ， 它 为 什么 会 存在 ， 它 做 什么 事 ， 应 该 怎么 用 。 如 采 名 称 需 要 注释 来 
补充 ， 那 就 不 算是 名 副 其 实 。 

int d; / 消逝 的 时 间 ， 以 日 计 

名 称 d 什 么 也 没 说 明 。 它 没有 引起 对 时 间 消 逝 的 感觉 ， 更 别 说 以 日 
计 了 。 我 们 应 该 选择 指明 了 计量 对 象 和 计量 单位 的 名 称 : 


int elapsedTimeInDays; 











int daysSinceCreation; 

int daysSinceModification; 

int fileAgeInDays; 

选择 体现 本 意 的 名 称 能 让 人 更 容易 理解 和 修改 代码 。 下 列 代码 的 目 
的 何在 ? 

public List<int[]> getThem() { 





List<int[]> list1 = new ArrayList<int[]>(); 
for (int[] x : theList) 
if (x[0] == 4) 
list1.add(x); 


return list]; 


} 

为 什么 难以 说 明 上 列 代码 要 做 什么 事 ? 里 面 并 没有 复杂 的 表达 式 。 
空格 和 缩 进 中 规 中 矩 。 只 用 到 三 个 变量 和 两 个 常量 。 甚 至 没有 涉及 任何 
其 他 类 或 多 态 方法 ， 只 是 (或 者 看 起 来 是 ) 一 个 数组 的 列表 而 已 。 

问题 不 在 于 代码 的 简洁 度 ， 而 是 在 于 代码 的 模糊 度 : 即 上 下 文 在 代 
码 中 未 被 明确 体现 的 程度 。 上 列 代 码 要 求 我 们 了 解 类 似 以 下 问题 的 答 


Ri 














(1) theList 中 是 什么 类 型 的 东西 ? 

(2) theList 零 下 标 条 目的 意义 是 什么 ? 

(3) 值 4 的 意义 是 什么 ? 

(4) 我 怎么 使 用 返回 的 列表 ? 

问题 的 答案 没 体现 在 代码 段 中 ， 可 那 就 是 它们 该 在 的 地 方 。 比 方 
说 ， 我 们 在 开发 一 种 扫雷 游戏 ， 我 们 发 现 ， 盘 面 是 名 为 theList 的 单元 格 
列表 ， 那 就 将 其 名 称 改 为 gameBoard。 

盘面 上 每 个 单元 格 都 用 一 个 简单 数组 表示 。 我 们 还 发 现 ， 零 下 标 条 
目 是 一 种 状态 值 ， 而 该 种 状态 值 为 4 表示 “已 标记 ”。 只 要 改 为 有 意义 的 
名 称 ， 代 码 就 会 得 到 相当 程度 的 改进 : 

public List<int[]> getFlaggedCells() { 

List<int[]> flaggedCells = new ArrayList<int[]>(); 





























for (int[] cell : gameBoard) 
if (celllSTATUS VALUE] == FLAGGED) 
flaggedCells.add(cell); 

return flaggedCells; 
} 
注意 ， 代 码 的 简洁 性 并 未 被 触及 。 运 算 符 和 常量 的 数量 全 然 保持 不 

变 ， 崩 套数 量 也 全 然 保 持 不 变 。 但 代码 变 得 明确 多 了 。 

还 可 以 更 进一步 ， 不 用 int 数组 表示 单元 格 ， 而 是 另 写 一 个 类 。 该 





类 包括 一 个 名 副 其 实 的 函数 〈 称 为 isFlagged) ， 从 而 掩盖 住 那个 魔术 
数 [1。 于 是 得 到 函数 的 新 版 本 : 
public List<Cell> getFlaggedCells() { 
List<Cell> flaggedCells = new ArrayList<Cell>(); 
for (Cell cell : gameBoard) 
if (cell.isFlagged()) 
flaggedCells.add(cell); 
return flaggedCells; 


~ 


只 要 简单 改 一 下 名 称 ， 就 能 轻易 知道 发 生 了 什么 。 这 就 是 选用 好 名 
称 的 力量 。 


2.3 避免 误导 





程序 员 必 须 避 人 免 留 下 掩藏 代码 本 意 的 错误 线索 。 应 当 避 人 免 使 用 与 本 
意 相 悖 的 词 。 例 如 ，hp、aix 和 sco 都 不 该 用 做 变量 名 ， 因 为 它们 都 是 
UNIX 平 台 或 类 UNIX 平 台 的 专 有 名 称 。 即 便 你 是 在 编写 三 角 计 算 程 序 ， 
hp 看 起 来 是 个 不 错 的 缩写 [2]， 但 那 也 可 能 会 提供 错误 信息 。 

别 用 accountList 来 指称 一 组 账号 ， 除 非 它 真 的 是 List 类 型 。List 一 词 
对 程序 员 有 特殊 音义 。 如 果 包 纳 账号 的 容器 并 非 真 是 个 List， 束 会 引起 
错误 的 判断 [3]。 所 以 ， 用 accountGroup 或 bunchOfAccounts， 甚 至 直接 用 
accounts 都 会 好 一 些 。 

提防 使 用 不 同 之 处 较 小 的 名 称 。 想 区 分 模块 中 某 处 的 
XYZControllerFor EfficientHandlingOfStrings 和 男 一 处 的 
XYZControllerForEfficientStorageOfStrings， 会 花 多 长 时 间 呢 ? 这 两 个 词 
外 形 实在 太 相 似 了 。 

以 同样 的 方式 拼写 出 同样 的 概念 才 是 信息 。 拼 写 前 后 不 一 致 就 是 误 
导 。 我 们 很 享受 现代 Java 编 程 环 境 的 自动 代码 完成 特性 。 键 入 某 个 名 称 
的 前 几 个 字母 ， 按 一 下 某 个 热 键 组 合 〈 如 果 有 的 话 ) ， 就 能 得 到 一 列 该 
名 称 的 可 能 形式 。 假 如 相似 的 名 称 依 字母 顺序 放 在 一 起 ， 且 差异 很 明 
显 ， 那 就 会 相当 有 助 益 ， 因 为 程序 员 多 半 会 压根 不 看 你 的 详细 注释 ， 甚 
至 不 看 该 类 的 方法 列表 就 直接 看 名 字 挑 一 个 对 象 。 

误导 性 名 称 真正 可 怕 的 例子 ， 是 用 小 写字 母 1 和 大 写字 母 0 作 为 变量 
名 ， 尤 其 是 在 组 合 使 用 的 时 候 。 当 然 ， 问 题 在 于 它们 看 起 来 完全 像 是 第 
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int a=]; 


1= 01; 
读者 可 能 会 认为 这 纯 属 虚构 ， 但 我 们 确 曾 见 过 充斥 这 类 玩意 的 代 
da 有 一 次 ， 代 码 作 者 建议 用 不 同 字体 写 变量 名 ， 好 显得 更 清楚 些 ， 不 
过 这 种 方案 得 要 通过 口头 和 书面 传递 给 未 来 所 有 的 开发 者 才 行 。 后 来 ， 
只 是 做 了 简单 的 重 命名 操作 ， 就 解决 了 问题 ， 而 且 也 没 搞 出 别 的 事 。 











2.4 意义 的 区 分 





如 末 程 友 员 只 是 为 满足 编译 器 或 解释 占 的 需要 而 写 代码 ， 残 会 制造 
暴 烦 。 例 如 ， 因 为 同一 作用 范围 内 两 样 不 同 的 东西 不 能 重 名 ， 你 可 能 会 
随手 改 挥 其 中 一 个 的 名 称 。 有 时 干脆 以 错误 的 拼写 序数 ， 结 果 就 是 出 现 
在 更 正 拼 写 错误 后 导致 编译 顺 出 错 的 情况 。 节 

光 是 添加 数字 系列 或 是 废话 远 远 不 够 ， 即 便 这 足以 让 编译 器 满意 。 
如 果 名 称 必 须 相 寞 ， 那 其 意思 也 应 该 不 同 才 对 。 

















以 数字 系列 命名 (al, a2, ...... aN) 是 依 义 命名 的 对 立 面 。 这 样 的 
名 称 纯 属 误 导 一 一 完全 没有 提供 正确 信息 ; 没有 提供 导向 作者 意图 的 线 
Ro WA: 
public static void copyChars(char a1[], char a2[]) 1 
for (int i = 0; i < al.length; i++) { 
a2[i] = alli]; 


} 

如 果 参 数 名 改 为 source 和 destination， 这 个 函数 就 会 像样 许多 。 

废话 是 另 一 种 没 意 义 的 区 分 。 假 设 你 有 一 个 Product 类 。 如 果 还 有 
一 个 _ ProductInfo 或 ProductData 类 ， 那 它们 的 名 称 虽 然 不 同 ， 意 思 却 无 
区 别 。Info 和 Data 就 像 a、an 和 the 一 样 ， 是 意义 含混 的 废话 。 

注意 ， 只 要 体现 出 有 意义 的 区 分 ， 使 用 a 和 the 这 样 的 前 级 就 没 错 。 
例如 ， 你 可 能 把 a 用 在 域内 变量 ， 而 把 the 用 于 函数 参数 [5]。 但 如 果 你 已 
经 有 一 个 名 为 zork 的 变量 ， 又 想 调 用 一 个 名 为 heZork 的 变量 ， 矿 烦 就 来 
Ta 

废话 都 是 元 余 。Variable 一 词 永 远 不 应 当 出 现在 变量 名 中 。Table 一 
词 永远 不 应 当 出 现在 表 名 中 。NameString 会 比 Name 好 吗 ? 难道 Name 会 
是 一 个 浮 点 数 不 成 ? 如 果 是 这 样 ， 就 触犯 了 关于 误导 的 规则 。 设 想 有 个 
名 为 Customer 的 类 ， 还 有 一 个 名 为 CustomerObject 的 类 。 区 别 何 在 呢 ? 
哪 一 个 是 表示 客户 历史 文 付 情况 的 最 佳 途径 ? 

有 个 应 用 反映 了 这 种 状况 。 为 当事者 讳 ， 我 们 改 了 一 下 ， 不 过 犯错 
的 代码 的 确 就 是 这 个 样子 : 


getActiveAccount(); 

















getActiveAccounts(); 

getActiveAccountInfo(); 

程序 员 怎 么 能 知道 该 调用 哪个 函数 呢 ? 

如 果 缺 少 明确 约定 ， 变 量 moneyAmount 就 与 money 没 区 别 ， 
customerInfo 5 customer? [X HJ, accountData 5Ejaccount? [X 5j] , 
theMessagetH Ejmessagei XU]. EXP, WEED E Be se In] 
处 的 方式 来 区 分 。 
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人 类 长 于 记忆 和 使 用 单词 。 大 脑 的 相当 一 部 分 就 是 用 来 容纳 和 处 理 
单词 的 。 单 词 能 读 得 出 来 。 人 类 进化 到 大 脑 中 有 那么 大 的 一 块 地 方 用 来 
处 理 言语 ， 寿 不 善 加 利用 ， 实 在 是 种 耻辱。 

如 果 名 称 读 不 出 来 ， 讨 论 的 时 候 就 会 像 个 傻 鸟 。" 哎 ， 这 儿 ， 曙 滋 
[sn] = 324855 (bee cee arr three cee enn tee) [6] E%, AAMEKRICHA 
(pee ess zee kyew) [7] 整 数 ， 看 见 没 ? ”这 不 是 小 事 ， 因 为 编程 本 就 是 
一 种 社会 活动 。 

有 家 公司 ， 程 序 里 面 写 了 个 genymdhms CERA, #, A, A, 
时 、 分 、 秒 ) ， 他 们 一 般 读 作 *“gen why emm dee aich emm ess”[8]。 我 有 
个 见 字 照 读 的 恶习 ， 于 是 开口 就 仿 “gen-yah-mudda-hims”。 后 来 好 些 设 
计 师 和 分 析 师 都 有 样 学 样 ， 听 起 来 傻乎乎 的 。 我 们 知道 典故 ， 所 以 会 觉 
得 很 搞笑 。 搞 笑 归 搞笑 ， 实 际 是 在 强 忍 糟糕 的 命名 。 在 给 新 开发 者 解释 
变量 的 意义 时 ， 他 们 总 是 读 出 傻乎乎 的 自 造 词 ， 而 非 恰 当 的 英语 词 。 比 


B 











class DtaRcrd102 { 
private Date genymdhms; 
private Date modymdhms; 
private final String pszqint = "102"; 
IF wwe 
H 
和 


class Customer { 


private Date generationTimestamp; 
private Date modificationTimestamp;; 
private final String recordId = "102"; 
Pha) 
y 
现在 读 起 来 就 像 人 话 了 : “ 喂 ，Mikey， 看 看 这 条 记录 ! 生成 时 间 戳 
(generation timestamp) [9] 被 设置 为 明天 了 ! 不 能 这 样 吧 ? ” 


2.6 H 名称 





单字 母 名 称 和 数字 种 量 有 个 问题 ， 就 是 很 难 在 一 大 篇 文字 中 找 出 
来 。 
找 MAX_CLASSES_PER_STUDENT 很 容易 ， 但 想 找 数字 7 就 麻烦 
了 ， 它 可 能 是 菜 些 文件 名 或 其 他 常量 定义 的 一 部 分 ， 出 现在 因 不 同意 图 
而 采用 的 各 种 表达 式 中 。 如 果 该 常量 是 个 长 数字 ， 又 被 人 错 改过 ， 就 会 
逃 过 搜索 ， 从 而 造成 错误 。 
同样 ，e 也 不 是 个 便于 搜索 的 好 变量 名 。 它 是 英文 中 最 常用 的 字 
母 ， 在 每 个 程序 、 每 段 代 码 中 都 有 可 能 出 现 。 由 此 而 见 ， 长 名 称 胜 于 短 
名 称 ， 搜 得 到 的 名 称 胜 于 用 目 造 编码 代 写 就 的 名 称 。 
鳃 以 为 单字 和 母 名 称 仅 用 于 短 方法 中 的 本 地 变量 。 名 称 长 短 应 与 其 作 
用 域 大 小 相对 应 [N5]。 若 变量 或 常量 可 能 在 代码 中 多 处 使 用 ， 则 应 赋 其 
以 便于 搜索 的 名 称 。 再 比较 
for (int j=0; j<34; j++) { 
s += (t[j]*4)/5; 
} 
和 
int realDaysPerldealDay = 4; 
const int WORK_DAYS_PER_WEEK = 5; 
int sum = 0; 
for (int j=0; j < NUMBER OF TASKS; j++) { 
int realTaskDays = taskEstimate[j] * realDaysPerIdealDay; 
int realTaskWeeks = (realdays / WORK, DAYS. PER. WEEK); 

















sum += realTaskWeeks; 
} 
注意 ， 上 面 代码 中 的 sum 并 非特 别 有 用 的 名 称 ， 不 过 它 至 少 搜 得 
到 。 采 用 能 表达 意图 的 名 称 ， 貌 似 拉 长 了 函数 代码 ， 但 要 想 想 看 ， 
WORK_DAYS_PER_WEFEK 要 比 数字 5 好 找 得 多 ， 而 列表 中 也 只 剩 下 了 
体现 作者 意图 的 名 称 。 





2.7 名 Zia Al 


编码 已 经 太 多 ， 无 谓 再 自 找 麻烦 。 把 类 型 或 作用 域 编 进 名 称 里 面 ， 
徒然 增加 了 解码 的 负担 。 没 理由 要 求 每 位 新 人 都 在 弄 清 要 应 付 的 代码 之 
外 《“ 那 算是 正 币 的 ) ， 还 要 再 搞 懂 为 一 种 编码 “语言 "。 这 对 于 解决 问题 
而 言 ， 纯 属 多 余 的 负担 。 带 编码 的 名 称 通常 也 不 便 发 首 ， 容 易 打 错 。 


2.7.1% Ji id 





TEETH MGE AHBS BB. RATE DI ER SSS A XA 
iB. WS ate MK. Fortran 语言 要 求 首 字母 体现 出 类 型 ， 导 致 了 编码 的 
产生 。BASIC 早期 版 本 只 人 允许 使 用 一 个 字母 再 加 上 一 位 数字 。 匈 牙 利 语 
标记 法 (Hungarian Notation, HN) 将 这 种 态势 愈演愈烈 。 

在 Windows 的 C 语 言 API 的 时 代 ，HN 相 当 重 要 ， 那 时 所 有 名 称 要 么 
是 个 整数 句柄 ， 要 么 是 个 长 指针 或 者 void 指针 ， 要 不 然 就 是 string 的 几 种 
实现 〈 有 不 同 的 用 途 和 属性 ) 之 一 。 那 时 候 编 译 器 并 不 做 类 型 检查 ， 程 
序 员 需 要 匈牙利 语 标记 法 来 帮助 自己 记 住 类 型 。 

现代 编程 语言 具有 更 丰富 的 类 型 系统 ， 编 译 器 也 记得 并 强制 使 用 类 
型 。 而 且 ， 人 们 趋向 于 使 用 更 小 的 类 、 更 短 的 方法 ， 好 让 每 个 变量 的 定 
义 都 在 视野 范围 之 内 。 

Java 程 序 员 不 需要 类 型 编码 。 对 象 是 强 类 型 的 ， 代 码 编辑 环境 已 经 
先进 到 在 编译 开始 前 就 侦 测 到 类 型 错误 的 程度 ! 所 以 ， 如 今 HN 和 其 他 
类 型 编码 形式 都 纯 属 多 余 。 它 们 增加 了 修改 变量 、 函 数 或 类 的 名 称 或 类 
型 的 难度 。 它 们 增加 了 阅读 代码 的 难度 。 它 们 制造 了 让 编码 系统 误导 读 
者 的 可 能 性 。 

















PhoneNumber phoneString; 
/ 类 型 变化 时 ， 名 称 并 不 变化 ! 


2.7.2 KIRI 
也 不 必用 m_ 前 级 来 标明 成 员 变 量 。 应 当 把 类 和 函数 做 得 足够 小 ， 
消除 对 成 员 前 缀 的 需要 。 你 应 当 使 用 东 种 可 以 高 亮 或 用 颜色 标 出 成 员 的 


编辑 环境 。 
public class Part { 





private String m_dsc; // The textual description 
void setName(String name) { 


m_dsc = name; 


public class Part { 
String description; 
void setDescription(String description) { 


this.description = description; 


} 

此 外 ， 人 们 会 很 快 学 会 无 视 前 级 (或 后 级 ) ， 只 看 到 名 称 中 有 意义 
的 部 分 。 代 码 读 得 越 多 ， 眼 中 就 越 没 有 前 级 。 最 终 ， 前 级 变 作 了 不 入 法 
眼 的 废料 ， 变 作 了 旧 代 码 的 标志 物 。 











2.7.3 接口 和 实现 


有 时 也 会 出 现 采 用 编码 的 特殊 情形 。 比 如 ， 你 在 做 一 个 创建 形状 用 





的 抽象 工厂 (Abstract Factory) 。 该 工厂 是 个 接口 ， 要 用 具体 类 来 实 
现 。 你 怎么 来 命名 工厂 和 具体 类 呢 ?IShapeFactory 和 ShapeFactory 吗 ? 
我 喜欢 不 加 修饰 的 接口 。 前 导 字 母 I 被 滥用 到 了 说 好 昕 点 是 干扰 ， 说 难 
听 点 根本 就 是 废话 的 程度 。 我 不 想 让 用 户 知道 我 给 他 们 的 是 接口 。 我 就 
想 让 他 们 知道 那 是 个 ShapeFactory。 如 果 接 口 和 实现 必须 选 一 个 来 编码 
的 话 ， 我 宁肯 选择 实现 。ShapeFactoryImp， 甚 至 是 丑陋 的 
CShapeFactory， 都 比 对 接口 名 称 编 码 来 得 好 。 

















2.8 ike Fi 2 | H h 


不 应 当 让 读者 在 脑 中 把 你 的 名 称 翻译 为 他 们 熟知 的 名 称 。 这 种 问题 
经 党 出 现在 选择 是 使 用 问题 领域 术语 还 是 解决 方案 领域 术语 时 。 

单字 母 变 量 名 就 是 个 问题 。 在 作用 域 较 小 、 也 没有 名 称 冲突 时 ， 循 
环 计数 器 自然 有 可 能 被 命名 为 ji 或 j 或 K。《 但 千 万 别 用 字母 1! ) 这 是 因 
为 传统 上 惯用 单字 母 名 称 做 循环 计数 器 。 然 而 ， 在 多 数 其 他 情况 下 ， 单 
字母 名 称 不 是 个 好 选择 ;读者 必须 在 脑 中 将 它 映射 为 真实 概念 。 仅 仅 是 
因为 有 了 a 和 b， 就 要 取 名 为 c， 实 在 并 非 像样 的 理由 。 

程序 员 通 常 都 是 聪明 人 。 聪 明 人 有 时 会 借 脑筋 急 转 弯 炫 光 其 聪明 。 
总 而 言 之 ， 假 使 你 记得 r 代 表 不 包含 主机 名 和 图 式 (scheme) 的 小 写字 
母 版 rl 的 话 ， 那 你 真是 太 陪 明了。 

聪明 程序 员 和 专业 程序 员 之 间 的 区 别 在 于 ， 专 业 程 序 员 了 解 ， 明 确 
是 王道 。 专 业 程 序 员 善 用 其 能 ， 编 写 其 他 人 能 理解 的 代码 。 























2.9 类 





类 名 和 对 象 名 应 该 是 名 词 或 名 词 短 语 ， 如 Customer、WikiPage、 
Account 和 AddressParser。 避 免 使 用 Manager、Processor、Data 或 Info 这 样 
的 类 名 。 类 名 不 应 当 是 动词 。 





2.10 方法 名 





方法 名 应 当 是 动词 或 动词 短语 ， 如 postPayment、deletePage 或 
save。 属 性 访问 器 、 修 改 器 和 断言 应 该 根据 其 值 命名 ， 并 依 Javabean 标 
准 [10] 加 上 get、set 和 is 前 级 。 

string name = employee.getName(); 

customer.setName("mike"); 

if (paycheck.isPosted())... 

重 载 构造 器 时 ， 使 用 描述 了 参数 的 静态 工厂 方法 名 。 例 如 ， 

Complex fulcrumPoint = Complex.FromRealNumber(23.0); 

通常 好 于 

Complex fulcrumPoint = new Complex(23.0); 


可 以 考虑 将 相应 的 构造 器 设置 为 private， 强 制 使 用 这 种 命名 手段 。 


2.11 别 扮 可 爱 





如 果 名 称 太 要 宝 ， 那 就 只 有 同 作者 一 般 有 幽默 感 的 人 才能 记得 住 ， 
而 且 还 是 在 他 们 记得 那个 笑话 的 时 候 才 行 。 谁 会 知道 名 为 
HolyHandGrenade[11] 的 函数 是 用 来 做 什么 的 呢 ? 没 错 ， 这 名 字 挺 伶 
俐 ， 不 过 DeleteItems[12] 或 许 是 更 好 的 名 称 。 宁 可 明确 ， 组 为 好 玩 。 





扮 可 爱 的 做 法 在 代码 中 经 党 体现 为 使 用 俗话 或 倡 语 。 例 如 ， 别 用 
whack( )[13] 来 表示 kill( )。 别 用 eatMyShorts( )[14] 这 类 与 文化 紧密 相关 的 
笑话 来 表示 abort( )。 

言 到 意 到 。 意 到 言 到 。 





给 每 个 抽象 概念 选 一 个 词 ， 并 且 一 以 贯 之 。 例 如 ， 使 用 fetch、 
retrieve 和 get 来 给 在 多 个 类 中 的 同 种 方法 命名 。 你 怎么 记得 住 哪个 类 中 
是 哪个 方法 呢 ? WER, (RG RE ERESIA, PURA, 
才能 想 得 起 来 用 的 是 哪个 术语 。 盏 则 ， 就 得 耗费 大 把 时 间 浏 蝶 各 个 文件 
头 及 前 面 的 代码 。 

Eclipse 和 IntellJ 之 类 现代 编程 环境 提供 了 与 环境 相关 的 线索 ， 比 如 
某 个 对 象 能 调用 的 方法 列表 。 不 过 要 注意 ， 列 表 中 通 第 不 会 给 出 你 为 函 
数 名 和 参数 列表 编写 的 注释 。 如 采 参 数 名 称 来 自 函 数 声明 ， 你 就 太 邓 运 
f. RAZ PY SAT, MAB RRB, REORDER MAIS R 
的 浏览 就 找到 正确 的 方法 。 

同样 ， 在 同一 堆 代 码 中 有 controller， 又 有 manager， 还 有 driver， 就 
会 令 人 困惑 。DeviceManager 和 Protocol-Controller 之 间 有 何 根 本 区 别 ? 
为 什么 不 全 用 controllers 或 managers? 他 们 都 是 Drivers 吗 ? 这 种 名 称 ， 
让 人 觉得 这 两 个 对 象 是 不 同类 型 的 ， 也 分 属 不 同 的 类 。 

对 于 那些 会 用 到 你 代码 的 程序 员 ， 一 以 贯 之 的 命名 法 简直 就 是 天 降 


ÍH TFT o 




















mk 


2.13 7j 大 语 





避免 将 同一 单词 用 于 不 同 目的 。 同 一 术语 用 于 不 同 概念 ， 基 本 上 就 
是 双关 语 了 。 如 有 果 遵 循 “ 一 词 一 义 ” 规 则 ， 可 能 在 好 多 个 类 里 面 都 会 有 
add 方 法 。 只 要 这 些 add 方 法 的 参数 列表 和 返回 值 在 语义 上 等 价 ， 就 一 切 
顺利 。 

但 是 ， 可 能 会 有 人 决定 为 “保持 一 致 ”* 而 使 用 add 这 个 词 来 命名 ， 即 
便 并 非 真 的 想 表 示 这 种 意思 。 比 如 ， 在 多 个 类 中 都 有 add 方 法 ， 该 方法 
通过 增加 或 连接 两 个 现存 值 来 获得 新 值 。 假 设 要 写 个 新 类 ， 该 类 中 有 一 
个 方法 ， 把 单个 参数 放 到 群集 (collection〉 中 。 该 把 这 个 方法 叫做 add 
吗 ? 这 样 做 貌似 和 其 他 add 方法 保持 了 一 致 ， 但 实际 上 语义 却 不 同 ， 应 
该 用 insert 或 append 之 类 词 来 命名 才 对 。 把 该 方法 命名 为 add， 就 是 双关 
语 了 。 

代码 作者 应 尽力 写 出 易于 理解 的 代码 。 我 们 想 把 代码 写 得 让 别人 能 
一 日 尽 疙 ， 而 不 必 辜 精 竭 虑 地 研究 。 我 们 想 要 那 种 大 众 化 的 作者 尽责 写 
清楚 的 平装 书 模式 ;我 们 不 想 要 那 种 学 者 挖 地 三 斥 才 能 明日 个 中 意义 的 
学 院 派 模式 。 

















2.14 ERIRE 水 


记 住 ， 只 有 程序 员 才 会 读 你 的 代码 。 所 以 ， 尽 管用 那些 计算 机 科学 
(Computer Science, CS) 术语 、 算 法 名 、 模 式 名 、 数 学 术语 吧 。 依 据 
问题 所 涉 领 域 来 命名 可 不 算是 聪明 的 做 法 ， 因 为 不 该 让 协作 者 老 是 跑 去 
问 客户 每 个 名 称 的 含义 ， 其 实 他 们 早 该 通过 另 一 名 称 了 解 这 个 概念 了 。 

对 于 熟悉 访问 者 CVISITOR) 模式 的 程序 来 说 ， 名 称 
AccountVisitor 富有 意义 。 哪 个 程序 员 会 不 知道 JobQueue 的 意思 呢 ? FE 
序 员 要 做 太 多 技术 性 工作 。 给 这 些 事 取 个 技术 性 的 名 称 ， 通 党 是 最 靠 谱 
的 做 法 。 





2.15 1 涉 问 题 领域 的 名 称 





如 果 不 能 用 程序 员 熟 悉 的 术语 来 给 手头 的 工作 命名 ， 惑 采用 从 所 涉 
问题 领域 而 来 的 名 称 吧 。 至 少 ， 负 责 维护 代码 的 程序 员 就 能 去 请 教 领域 
ERI o 

优秀 的 程序 员 和 设计 师 ， 其 工作 之 一 就 是 分 离 解决 方案 领域 和 问题 
领域 的 概念 。 与 所 涉 问题 领域 更 为 贴近 的 代码 ， 应 当 采 用 源 目 问题 领域 
的 名 称 。 





2.16 Ys 意义 的 语 培 





很 少 有 名 称 是 能 自我 次 明 的 一 一 多 数 都 不 能 。 上 反之， 你 需要 用 有 民 
好 命名 的 类 、 函 数 或 名 称 空间 来 放置 名 称 ， 给 读者 提供 语 境 。 如 果 没 这 
么 做 ， 给 名 称 添加 前 级 就 是 最 后 一 招 了 。 

设想 你 有 名 为 firstrName、lastName、street、houseNumber、city、 
state 和 zipcode 的 变量 。 当 它们 搁 一 块 儿 的 时 候 ， 很 明确 是 构成 了 一 个 地 
Hb. PE, dB HERE HEURE WIESE stated, EET 你 会 理 
Hir RT TARE ASI B E — 554) R3 ? 

n] EAS BU Zi addrFirstName, addrLastName. addrState:, LAME 
供 语 境 。 至 少 ， 读 者 会 明日 这 些 变量 是 某 个 更 大 结构 的 一 部 分 。 当 然 ， 
更 好 的 方案 是 创建 名 为 Address 的 类 。 这 样 ， 即 便 是 编译 器 也 会 知道 这 
些 变量 隶属 某 个 更 大 的 概念 了 。 

看 看 代码 清单 2-1 中 的 方法 。 以 下 变量 是 否 需 要 更 有 意义 的 语 境 
Ni? PALA MZ INN SER d 34 Peo. Wa a R AUS 
你 会 知道 number、verb 和 pluralModifier 这 三 个 变量 是 “ 测 估 ” 信 息 的 一 部 
分 。 不 幸 的 是 这 语 境 得 靠 读 者 推 邮 出 来 。 第 一 眼看 到 这 个 方法 时 ， 这 些 
变量 的 含义 完全 不 清楚 。 

代码 清单 2-1 语 境 不 明确 的 变量 


private void printGuessStatistics(char candidate, int count) { 




















String number; 

String verb; 

String plural Modifier; 
if (count == 0) { 


number = "no"; 

verb = "are"; 

pluralModifier = "s"; 
} else if (count == 1) { 


number = "1"; 


verb = "is"; 
pluralModifier = ""; 
} else { 


number = Integer.toString(count); 
verb = "are"; 
pluralModifier = "s"; 
} 
String guessMessage = String.format( 
"There %s %s %s%s", verb, number, candidate, pluralModifier 
); 
print(guessMessage); 
} 
上 列 函 数 有 点 儿 过 长 ， 变 量 的 使 用 员 穿 始终 。 要 分 解 这 个 函数 ， 需 
要 创建 一 个 名 为 GuessStatisticsMessage 的 类 ， 把 三 个 变量 做 成 该 类 的 成 
员 字 段 。 这 样 它们 就 在 定义 上 变 作 了 GuessStatisticsMessage 的 一 部 分 。 
语 境 的 增强 也 让 算法 能 够 通过 分 解 为 更 小 的 函数 而 变 得 更 为 干净 利落。 
《如 代码 清单 2-2 所 示 。 ) 
代码 清单 2-2 有 语 境 的 变量 


public class GuessStatisticsMessage { 




















private String number; 
private String verb; 


private String plural Modifier; 


public String make(char candidate, int count) { 
createPluralDependentMessageParts(count); 
return String.format( 
"There 96s 96s 96s96s", 
verb, number, candidate, pluralModifier ); 
j 
private void createPluralDependentMessageParts(int count) { 
if (count == 0) { 
thereAreNoLetters(); 
} else if (count == 1) { 
thereIsOneLetter(); 
} else { 
thereAreManyLetters(count); 


} 
private void thereAreManyLetters(int count) { 
number = Integer.toString(count); 
verb = "are"; 
pluralModifier = "s"; 
} 
private void thereIsOneLetter() 1 
number - "1"; 


Ws Ot, 


verb = "is"; 
pluralModifier = ""; 

} 

private void thereAreNoLetters() { 


number = "no"; 


verb = "are"; 


pluralModifier = "s"; 





设 知 有 一 个 名 为 “加 油 站 豪华 版 ”〈Gas Station Deluxe) 的 应 用 ， 在 
其 中 给 每 个 类 添加 GSD 前 缀 就 不 是 什么 好 点 子 。 说 白 了 ， 你 是 在 和 自己 
在 用 的 工具 过 不 去 。 输 入 G， 按 下 上 自动 完成 键 ， 结 果 会 得 到 系统 中 全 部 
类 的 列表 ， 列 表 恨 不 得 有 一 英里 那么 长 。 这 样 做 聪明 吗 ? AT A ES 
IDE 没 法 帮助 你 ? 

再 比如 ， 你 在 GSD 应 用 程序 中 的 记 账 模块 创建 了 一 个 表示 邮件 地 址 
的 类 ， 然 后 给 该 类 命名 为 GSDAccountAddress。 稍 后 ， 你 的 客户 联络 应 
用 中 需要 用 到 邮件 地 址 ， 你 会 用 GSDAccountAddress 吗 ?这 名 字 听 起 来 
没 问题 吗 ? 在 这 17 个 字母 里 面 ， 有 10 个 字母 纯 属 多 余 和 与 当前 语 境 毫 无 
KK. 
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对 于 Address 类 的 实体 来 说 ，accountAddress 和 customerAddress 都 是 
不 错 的 名 称 ， 不 过 用 在 类 名 上 就 不 太 好 了 。Address 是 个 好 类 名 。 如 果 
需要 与 MAC 地 址 、 端 口 地 址 和 Web 地 址 相 区 别 ， 我 会 考虑 使 用 
PostalAddress、MAC 和 URI。 这 样 的 名 称 更 为 精确 ， 而 精确 正 是 命名 的 


TH 
SER. 


2.18 最 后 的 话 


取 好 名 字 最 难 的 地 方 在 于 需要 良好 的 描述 技巧 和 共有 文化 背景 。 与 
其 说 这 是 一 种 技术 、 商 业 或 管理 问题 ， 还 不 如 说 是 一 种 教学 问题 。 其 结 
果 是 ， 这 个 领域 内 的 许多 人 都 没 能 学 会 做 得 很 好 。 

我 们 有 时 会 人 其 他 开发 者 反对 重 命名 。 如 果 讨 论 一 下 就 知道 ， 如 宁 
名 称 改 得 更 好 ， 那 大 家 真 的 会 感激 你 。 多 数 时 候 我 们 并 不 记忆 类 名 和 方 
法 名 。 我 们 使 用 现代 工具 对 付 这 些 细 市 ， 好 让 自己 集中 精力 于 把 代码 写 
得 就 像 词句 篇 革 、 人 至 少 像 是 表 和 数据 结构 (词句 并 非 总 是 呈现 数据 的 最 
佳 手 段 )。 改 名 可 能 会 让 某 人 吃惊 ， 残 像 你 做 到 其 他 代码 改善 工作 一 
样 。 别 让 这 种 事 阻碍 你 的 前 进步 伐 。 

不 妨 试 试 上 面 这 些 规则 ， 看 你 的 代码 可 读 性 是 否 有 所 提升 。 如 果 你 
是 在 维护 别人 写 的 代码 ， 使 用 重 构 工具 来 解决 问题 。 效 果 立 年 见 影 ， 而 
且 会 持续 下 去 。 














DLE: 即 表示 已 标记 的 4。 
[2]. 译 注 : 即 hypotenuse 的 缩写 。 


BLEE: 如 后 文 提 到 的 ， 即 便 容器 就 是 个 List， 最 好 也 别 在 名 称 中 写 出 
容器 类 型 名 。 


[4]. 原 注 : 例如 ， 束 因为 class 已 有 他 用 ， 束 给 一 个 变量 命名 为 kass， 这 
真是 可 怕 的 做 法 。 


BLEE: 鲍 动 大 叔 惯 于 在 C++ 中 这 样 做 ， 但 后 来 放弃 了 ， 因 为 现代 IDE 
使 这 种 做 法 变 得 没 必要 了 。 


[6 译注: BCR3CNT 的 读音 。 


[ZL AYE: PSZQ 的 读音 。 


[81]. 译 注 : YMDHMS 的 读音 。 





[91. 译 注 : 读 到 generation timestamp 时 ， 立 刻 就 能 与 代码 中 的 
generationTimestamp 变 量 对 应 上 。 


[10]. 原 注 : http://java.sun.com/products/javabeans/docs/spec.html。 





[1]1. 译 注 ， 意 为 “圣手 手雷 ”。 
[121. 译 注 : 意 为 “删除 条 目 ”。 
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在 编程 的 早年 岁月 ， 系 统 由 程序 和 子 程序 组 成 。 后 来 ， 在 Fortran 和 
PL/1 的 年 代 ， 系 统 由 程序 、 子 程序 和 函数 组 成 。 如 今 ， 只 有 函数 存活 下 
来 。 函 数 是 所 有 程序 中 的 第 一 组 代码 。 本 章 将 讨论 如 何 写 好 函数 。 

请 看 代码 清单 3-1。 在 FitNesse[H 中 ， 很 难 找到 长 函数 ， 不 过 我 还 是 














搜寻 到 一 个 。 它 不 光 长 ， 而 且 代 码 也 很 复杂 ， 有 大 量 字 符 串 、 怪 异 而 不 
显 见 的 数据 类 型 和 API。 花 3 分 钟 时 间 ， 看 能 读 懂 多 少 ? 
代码 清单 3-1 HtmlUtil.java (FitNesse 20070619) 
public static String testableHtml( 
PageData pageData, 
boolean includeSuiteSetup 
) throws Exception { 
WikiPage wikiPage = pageData.getWikiPage(); 
StringBuffer buffer = new StringBuffer(); 
if (pageData.hasAttribute("Test")) { 
if (includeSuiteSetup) { 
WikiPage suiteSetup = 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUTTE_SETUP_NAME, wikiPage 


); 
if (suiteSetup != null) { 
WikiPagePath pagePath = 


suiteSetup.getPageCrawler().getFullPath(suiteSetup); 
String pagePathName = PathParser.render(pagePath); 
buffer.append("!include -setup .") 


.append(pagePathName) 
.append("\n"); 
} 
} 
WikiPage setup = 


PageCrawlerImpl.getInheritedPage("SetUp", wikiPage); 
if (setup != null) { 


WikiPagePath setupPath = 
wikiPage.getPageCrawler().getFullPath(setup); 
String setupPathName = PathParser.render(setupPath); 
buffer.append("!include -setup .") 
.append(setupPathName) 
.append("\n"); 


} 
buffer.append(pageData.getContent()); 
if (pageData.hasAttribute("Test")) { 
WikiPage teardown = 
PageCrawlerImpl.getInheritedPage("TearDown", wikiPage); 
if (teardown != null) { 
WikiPagePath tearDownPath = 
wikiPage.getPageCrawler().getFullPath(teardown); 
String tearDownPathName = PathParser.render(tearDownPath); 
buffer.append("\n") 
.append("'include -teardown .") 
.append(tearDownPathName) 
.append("\n"); 
} 
if (includeSuiteSetup) { 
WikiPage suiteTeardown = 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder.SUITE TEARDOWN NAME, 
wikiPage 


y; 


if (suiteTeardown != null) { 
WikiPagePath pagePath = 
suiteTeardown.getPageCrawler().getFullPath 
(suiteTeardown); 
String pagePathName = PathParser.render(pagePath); 
buffer.append("!include -teardown .") 
.append(pagePathName) 
.append("\n"); 


} 
pageData.setContent(buffer.toString()); 
return pageData.getHtml(); 
} 
fig IA PRA NG? 大 概 没有 。 有 太 多 事 发 生 ， 有 太 多 不 同 层 级 的 
抽象 。 奇 怪 的 字符 串 和 函数 调用 ， 混 以 双重 艇 套 、 用 标识 来 控制 的 f 语 
句 等 ， 不 一 而 足 。 
不 过 ， 只 要 做 几 个 简单 的 方法 抽 离 和 重 命名 操作 ， 加 上 一 点 点 重 
构 ， 就 能 在 9 行 代码 之 内 搞 搞 〈( 如 代码 清单 3-2 所 示 〉 。 用 3 分 钟 阅读 以 
下 代码 ， 看 你 能 理解 吗 ? 
代码 清单 3-2 HtmlUtil.java ( 重 构 之 后 ) 
public static String renderPageWithSetupsAndTeardowns( 





PageData pageData, boolean isSuite 
) throws Exception { 
boolean isTestPage = pageData.hasAttribute("Test"); 
if (isTestPage) { 
WikiPage testPage = pageData.getWikiPage(); 


StringBuffer newPageContent = new StringBuffer(); 
includeSetupPages(testPage, newPageContent, isSuite); 
newPageContent.append(pageData.getContent()); 
includeTeardownPages(testPage, newPageContent, isSuite); 
pageData.setContent(newPageContent.toString()); 
} 
return pageData.getHtml(); 
} 
除非 你 正在 研究 FitNesse， 盏 则 就 理解 不 了 所 有 细 市 。 不 过 ， 你 大 
概 能 明白 ， 该 函数 包含 把 一 些 设置 和 拆 解 页 放 入 一 个 测试 页 面 ， 再 泻 染 
为 HTML 的 操作 。 如 果 你 熟悉 JUnit[2]， 或 许 会 想到 ， 该 函数 归属 于 某 个 
基于 Web 的 测试 框架 。 而 且 ， 这 当然 没 错 。 从 代码 清单 3-2 中 获得 信息 
IRAE A), es 3-10 ERE MEI 
是 什么 让 代码 清单 3-2 易 于 阅读 和 理解 ?怎么 才能 让 函数 表达 其 意 
图 ?该 给 函数 赋予 哪些 属性 ， 好 让 读者 一 看 就 明日 函数 是 属于 怎样 的 程 
序 ? 








函数 的 第 一 规则 是 要 短小 。 第 二 条 规则 是 还 要 更 短小 。 我 无 法 证 明 
这 个 断言 。 我 给 不 出 任何 证 实 了 小 函数 更 好 的 研究 结果 。 我 能 说 的 是 ， 
近 40 年 来 ， 我 写 过 各 种 不 同 大 小 的 函数 。 我 写 过 令 人 习 恶 的 长 达 3000 行 
的 大 物 ， 也 写 过 许多 100 行 到 300 行 的 函数 ， 我 还 写 过 20 行 到 30 行 的 。 经 
过 漫长 的 试 错 ， 经 验 告诉 我 ， 函 数 就 该 小 。 

在 20 世 纪 80 年 代 ， 我 们 常 说 函数 不 该 长 于 一 屏 。 当 然 ， 说 这 话 的 时 
候 ，VT100 屏 幕 只 有 24 行 、80 列 ， 而 编辑 器 就 得 先 占 去 4 行 空 间 放 来 
单 。 如 今 ， 用 上 了 精致 的 字体 和 宽大 的 显示 器 ， 一 屏 里 面 可 以 显示 100 
行 ， 每 行 能 容纳 150 个 字符 。 每 行 都 不 应 该 有 150 个 字符 那么 长 。 函 数 也 
不 该 有 100 行 那么 长 ，20 行 封顶 最 佳 。 

函数 到 底 该 有 多 长 ? 1991 年 ， 我 去 Kent Beck 位 于 奥 勒 囚 州 
(Oregon) 的 家 中 拜访 。 我 们 坐 到 一 起 写 了 些 代 码 。 他 给 我 看 一 个 叫做 
Sparkle (4K 7E INE) 的 有 趣 的 Java/Swing 小 程序 。 程 序 在 屏幕 上 描画 电 
Cinderella 〈《 灰 姑娘 》) 中 仙女 用 魔 棒 造 出 的 那 种 视觉 效果 。 只 要 移 
动 鼠 标 ， 光 标 所 在 处 就 会 爆发 出 一 团 令 人 欣喜 的 火花 ， 沿 着 模拟 重力 场 
划 落 到 窗口 底部 。 肯 特 给 我 看 代码 的 时 候 ， 我 惊讶 于 其 中 那些 函数 尺寸 
之 小 。 我 看 惯 了 Swing 程 序 中 长 度数 以 里 计 的 函数 。 但 这 个 程序 中 每 个 
函数 都 只 有 两 行 、 三 行 或 四 行 长 。 每 个 函数 都 一 目 了 然 。 每 个 函数 都 只 
说 一 件 事 。 而 且 ， 每 个 函数 都 依 序 把 你 带 到 下 一 个 函数 。 这 就 是 函数 应 
该 达到 的 短小 程度 ! [3] 

函数 应 该 有 多 短小 ?通常 来 说 ， 应 该 短 于 代码 清单 3-2 中 的 函数 ! 
代码 清单 3-2 实 在 应 该 缩短 成 代码 清单 3-3 这 个 样子 。 
































代码 清单 3-3 HtmlUtil.java (再 次 重 构 之 后 ) 
public static String renderPageWithSetupsAndTeardowns( 
PageData pageData, boolean isSuite) throws Exception { 
if (isTestPage(pageData)) 
includeSetupAndTeardownPages(pageData, isSuite); 
return pageData.getHtml(); 
} 
代码 块 和 缩 进 
让 语句 、else 语 句 、while 语 句 等 ， 其 中 的 代码 块 应 该 只 有 一 行 。 该 
行 大 抵 应 该 是 一 个 函数 调用 语句 。 这 样 不 但 能 保持 函数 短小 ， 而 且 ， 因 
为 块 内 调用 的 函数 拥有 较 具 说 明 性 的 名 称 ， 从 而 增加 了 文档 上 的 价值 。 
这 也 意味 着 函数 不 应 该 大 到 足以 容纳 冬 套 结 构 。 所 以 ， 函 数 的 缩 进 
层级 不 该 多 于 一 层 或 两 层 。 当 然 ， 这 样 的 函数 易于 阅读 和 理解 。 














3.2 只 做 一 件 事 


代码 清单 3-1 显 然 想 做 好 几 件 事 。 它 创建 缓冲 区 、 获 取 页 面 、 搜 索 
继承 下 来 的 页 面 、 泻 染 路 符 、 添 加 神秘 的 字符 串 、 生 成 HTML， 如 此 每 
和 等。 代码 清单 3-1 手 忙 脚 乱 。 而 代码 清单 3-3 则 只 做 一 件 简 单 的 事 。 它 将 
设置 和 拆 解 包 纳 到 测试 页 面 中 。 

过 去 30 年 以 来 ， 以 下 建议 以 不 同形 式 一 再 出 现 : 

阔 数 应 该 做 一 件 事 。 做 好 这 件 事 。 只 做 这 一 件 事 。 

问题 在 于 很 难 知道 那 件 该 做 的 事 是 什么 。 代 码 清 单 3-3 只 做 了 一 件 
事 ， 对 吧 ? 其 实 也 很 容易 看 作 是 三 件 事 : 

(1) 判断 是 否 为 测试 页 面 ; 

(2) 如 果 是 ， 则 容纳 进 设置 和 分 拆 步 又; 

(3) 演 染 成 HTML。 











那 件 事 是 什么 ? 函数 是 做 了 一 件 事 呢 ， 还 是 做 了 三 件 事 ? 注意 ， 这 
三 个 步 又 均 在 该 函数 名 下 的 同一 抽象 屋 上 。 可 以 用 简洁 的 TO[4] 起 头 段 
沙 来 描述 这 个 函数 : 

TO RenderPageWithSetupsAndTeardowns, we check to see whether the 
page is a test page and if so, we include the setups and teardowns. In either 
case we render the page in HTML. 

(要 RenderPageWithSetupsAndTeardowns， 检 查 页 面 是 否 为 测试 
Ji. WAREMAN, MAAR EMO. AEA AM, Ae 
YL HTML) 

如 果 函 数 只 是 做 了 该 函数 名 下 同一 抽象 层 上 的 步 又 ， 则 函数 还 是 只 

做 了 一 件 事 。 编 写 函数 毕竟 是 为 了 把 大 一 些 的 概念 〈 换 言 之 ， 函 数 的 名 
PR) 拆 分 为 另 一 抽象 层 上 的 一 系列 步骤 。 
代码 清单 3-1 明 显 包括 了 处 于 多 个 不 同 抽象 层级 的 步骤 。 显 然 ， 它 














所 做 的 不 止 一 件 事 。 即 便 是 代码 清单 3-2 也 有 两 个 抽象 层 ， 这 已 被 我 们 
将 其 缩短 的 能 力 所 证 明 。 然 而 ， 很 难 再 将 代码 清单 3-3 做 有 意义 的 缩 
短 。 可 以 将 if 语 句 拆 出 来 做 一 个 名 为 includeSetupAndTeardonws 
IfTestpage 的 函数 ， 但 那 只 是 重新 诠释 代码 ， TREO 象 层 级 。 
所 以 ， 不 止 做 了 一 件 事 ， 还 有 一 个 方法 ， 就 是 看 是 
能 再 拆 出 一 个 函数 ， 该 函数 不 仅 只 是 单纯 地 重新 诠释 其 实现 [G34]。 
函数 中 的 区 段 
请 看 代码 清单 47。 注 意 ，generatePrimes 函 数 被 切 分 为 
declarations、initializations 和 sieve 等 区 段 。 这 惑 是 函数 做 事 太 多 的 明显 
征兆 。 只 做 一 件 事 的 函数 无 法 被 合理 地 切 分 为 多 个 区 段 。 

















要 确保 函数 只 做 一 件 事 ， 函 数 中 的 语句 都 要 在 同一 抽象 层级 上 。 
眼 就 能 看 出 ， 代 人 码 清单 3-1 违反 了 这 条 规矩 。 那 里 面 有 getHtml( id 
较 高 抽象 层 的 概念 ， 也 有 String e 
PathParser.render(pagePath) 等 位 于 中 间 抽 象 层 的 概念 ， mg 
等 位 于 相当 低 的 抽象 层 的 概念 。 

函数 中 混杂 不 同 抽象 层级 ， 往 往 让 人 迷惑 。 读 者 可 能 无 法 判断 某 个 
表达 式 是 基础 概念 还 是 细节 。 更 恶劣 的 是 ， 就 像 破损 的 窗户 ， 一 旦 细节 
与 基础 概念 混杂 ， 更 多 的 细 市 就 会 在 函数 中 纠结 起 来 。 

AHI PERA: qup p 

我 们 想 要 让 代码 拥有 自 项 同 下 的 阅读 顺序 。[5] 我 们 想 要 让 每 个 函数 
后 面 都 跟着 位 于 下 一 抽象 层级 的 函数 ， 这 样 一 来 ， 在 但 看 函数 列表 时 ， 
就 能 全 抽象 层级 癌 下 阅读 了 。 我 把 这 叫做 向 下 规则 。 

换 一 种 说 法 。 我 们 想 要 这 样 读 程序 : 程序 就 像 是 一 系列 TO 起 头 的 
段 洲 ， 每 一 段 都 描述 当前 抽象 层级 ， 并 引用 位 于 下 一 抽象 层级 的 后 续 
TO 起 头 段落 。 


To include the setups and teardowns, we include setups, then we include 





the test page content, and then we include the teardowns.( 要 容纳 设置 和 分 
拆 步 又 ， 就 先 容 纳 设置 步骤 ， 然 后 纳入 测试 页 面 内 容 ， 再 纳入 分 拆 步 
R. ) 

To include the setups, we include the suite setup if this is a suite, then we 
include the regular setup. 0° 如 果 是 套件 ， 就 纳入 套件 
设置 步 又， 然后 再 纳入 普通 设置 步骤 。 


To include the suite setup, we search the parent hierarchy for 
the“SuiteSetUp”page and add an include statement with the path of that 
page.《〈 要 容纳 套件 设置 步骤 ， 先 搜索 “SuiteSetUp ”页 面 的 上 级 继承 关 
系 ， 再 添加 一 个 包括 该 页 面 路 径 的 语句 。) 

To search the parent... (要 搜索 ..…..) 

程序 员 往 往 很 难 学 会 遵循 这 条 规则 ， 写 出 只 停留 于 一 个 抽象 层级 上 
的 函数 。 尽 管 如 此 ， 学 习 这 个 技巧 还 是 很 重要 。 这 是 保持 函数 短小 、 确 
保 只 做 一 件 事 的 要 诀 。 让 代码 读 起 来 像 是 一 系列 目 顶 同 下 的 TO 起 头 段 
沙 是 保持 抽象 层级 协调 一 致 的 有 效 技 巧 。 

看 看 本 章 末 尾 的 代码 清单 3-7。 它 展示 了 遵循 这 条 原则 重 构 的 完整 
testableHtml 函 数 。 留 意 每 个 函数 是 如 何 引 出 下 一 个 函数 ， 如 何 保持 在 同 
一 抽象 屋 上 的 。 

















3.4 switchi# ^] 


写 出 短小 的 Switch 语句 很 难 [61。 即 便 是 只 有 两 种 条 件 的 switch 语 名 
也 要 比 我 想 要 的 单个 代码 块 或 函数 大 得 多 。 写 出 只 做 一 件 事 的 switch 语 
—- Switch 天 生 要 做 N 件 事 。 不 幸 我 们 总 无 法 避 开 switch 语 句 ， 不 

还 是 能 够 确保 每 个 switch 都 埋藏 在 较 低 的 抽象 层级 ， 而 且 永远 不 重 
1... +. 

请 看 代码 清单 3-4。 它 呈现 了 可 能 依赖 于 雇员 类 型 的 仅仅 一 种 操 
(Re 

代码 清单 3-4 Payroll.java 

public Money calculatePay(Employee e) 














throws InvalidEmployeeType { 
Switch (e.type) { 
case COMMISSIONED: 
return calculateCommissionedPay(e); 
case HOURLY: 
return calculateHourlyPay(e); 
case SALARIED: 
return calculateSalariedPay(e); 
default: 
throw new InvalidEmployeeType(e.type); 


一 一 





该 函数 有 好 几 个 问题 。 首 先 ， 它 太 长 ， 当 出 现 新 的 雇员 类 型 时 ， 


PIER, KK, CHEMI DEFE. B=, CER SAAE 
原则 (Single Responsibility Principle[7], SRP) ， 因 为 有 好 几 个 修改 它 的 
理由 。 第 四 ， 它 违反 了 开放 闭合 原则 (Open Closed Principle[8], 
OCP) , ANRE SRIMA, MUSK. A, AeA ew 
NAT Sé SUA A AWA AeA. DU. RESA 

isPayday(Employee e, Date date), 

或 

deliverPay(Employee e, Money pay), 

如 此 等 等 。 它 们 的 结构 都 有 同样 的 问题 。 

该 问题 的 解决 方案 (如 代码 清单 3-5 所 示 〉 是 将 switch 语 句 埋 到 抽象 
工厂 [9] 底 下 ， 不 让 任何 人 看 到 。 该 工厂 使 用 switch 语 句 为 Employee 的 派 
生物 创建 适当 的 实体 ， 而 不 同 的 函数 ， 如 calculatePay、isPayday 和 
deliverPayAs, Jl # HEmployeełž L1 ASH P2 52 IRIE « 

对 于 switch 语 句 ， 我 的 规矩 是 如 果 只 出 现 一 次 ， 用 于 创建 多 态 对 
象 ， 而 且 隐 藏 在 东 个 继承 关系 中 ， 在 系统 其 他 部 分 看 不 到 ， 就 还 能 容忍 
[G23]。 当 然 也 要 就 事 论 事 ， 有 时 我 也 会 部 分 或 全 部 违反 这 条 规矩 。 

代码 清单 3-5 Employee 与 工厂 


public abstract class Employee { 























public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 


public interface EmployeeFactory { 
public Employee makeEmployee(EmployeeRecord r) throws 
InvalidEmployeeType; 
} 


public class EmployeeFactoryImpl implements EmployeeFactory { 
public Employee makeEmployee(EmployeeRecord r) throws 
InvalidEmployeeType { 
switch (r.type) { 
case COMMISSIONED: 
return new CommissionedEmployee(r) ; 
case HOURLY: 
return new HourlyEmployee(r); 
case SALARIED: 
return new SalariedEmploye(r); 
default: 
throw new InvalidEmployeeType(r.type); 


3.5 B DE EA 4 BK 


在 代码 清单 3-7 中 ， 我 把 示例 函数 的 名 称 从 testableHtml 改 为 
SetupTeardownIncluder.render。 这 个 名 称 好 得 多 ， 因 为 它 较 好 地 摘 述 了 
函数 做 的 事 。 我 也 给 每 个 私有 方法 取 个 同样 具有 描述 性 的 名 称 ， 如 
isTestable 或 includeSetupAndTeardownPages。 好 名 称 的 价值 怎么 好 评 都 
不 为 过 。 记 住 沃 德 原 则 : “如果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 
整洁 代码 。” 要 遵循 这 一 原则 ， 泰 半 工 作 都 在 于 为 只 做 一 件 事 的 小 函数 
取 个 好 名 字 。 函 数 越 短小 、 功 能 越 集 中 ， 就 越 便于 取 个 好 名 字 。 

别 害怕 长 名 称 。 长 而 具有 描述 性 的 名 称 ， 要 比 短 而 令 人 费解 的 名 称 
好 。 长 而 具有 描述 性 的 名 称 ， 要 比 描述 性 的 长 注释 好 。 使 用 某 种 命名 约 
定 ， 让 函数 名 称 中 的 多 个 单词 容易 阅读 ， 然 后 使 用 这 些 单词 给 函数 取 个 
能 说 清 其 功用 的 名 称 。 

别 害怕 花 时 间 取 名 字 。 你 当 壬 试 不 同 的 名 称 ， 实 测 其 阅读 效果 。 在 
Eclipse 或 InteliJ 等 现代 IDE 中 改名 称 易 如 反 擎 。 使 用 这 些 IDE 测 试 不 同名 
称 ， 直 至 找到 最 具有 描述 性 的 那 一 个 为 止 。 

选择 摘 述 性 的 名 称 能 理 清 你 关于 模块 的 设计 思路 ， 并 帮 你 改进 之 。 
奶 索 好 名 称 ， 往 往 导致 对 代码 的 改善 重 构 。 

命名 方式 要 保持 一 致 。 使 用 与 模块 名 一 脉 相 承 的 短语 、 名 词 和 动词 
给 函数 命名 。 例 如 ，includeSetupAndTeardownPages、 
includeSetupPages、includeSuiteSetupPage 和 includeSetupPage 等 。 这 些 名 
称 使 用 了 类 似 的 措辞 ， 依 序 讲 出 一 个 故事 。 实 际 上 ， 假 使 我 只 给 你 看 上 
ARB I, VR EI: “includeTeardownPages. 
includeSuiteTeardownPages #llincludeTeardownPage X. fo] 2. ”这 就 是 所 

















3.6 函数 参数 


最 理想 的 参数 数量 是 零 〈 零 参数 函数 ) ， 其 次 是 一 〈 单 参数 函 
数 ) ， 再 次 是 二 《〈 双 参数 函数 ) ， 应 尽量 避免 三 (三 参数 函数 ) 。 有 足 
够 特殊 的 理由 才能 用 三 个 以 上 参数 (多 参数 函数 ) 一 一 所 以 无 论 如 何 也 
不 要 这 么 做 。 

参数 不 易 对 付 。 它 们 带 有 太 多 概念 性 。 所 以 我 在 代码 范例 中 几乎 不 
加 参数 。 比 如 ， 以 StringBuffer 为 例 ， 我 们 可 能 不 把 它 作 为 实体 变量 ， 而 
是 当 作 参数 来 传递 ， 那 样 的 话 ， 读 者 每 次 看 到 它 都 得 要 翻译 一 这 。 阅 读 
模块 所 讲述 的 故事 时 ，includeSetupPage( ) 要 比 
includeSetupPageInto (newPage-Content) 易于 理解 。 参 数 与 函数 名 处 在 
不 同 的 抽象 层级 ， 它 要 求 你 了 解 目 前 并 不 特别 重要 的 细节 《 即 那个 
StringBuffer) 。 











从 测试 的 角度 看 ， 参 数 甚至 更 叫 人 为 难 。 想 想 看 ， 要 编写 能 确保 参 
数 的 各 种 组 合 运 行 正常 的 测试 用 例 ， 是 多 么 困难 的 事 。 如 末 没 有 参数 ， 
就 是 小 染 一 碟 。 如 果 只 有 一 个 参数 ， 也 不 太 困 难 。 有 两 个 参数 ， 问 题 就 
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输出 参数 比 输入 参数 还 要 难以 理解 。 读 函数 时 ， 我 们 惯 于 认为 信息 
通过 参数 输入 函数 ， 通 过 返回 值 从 函数 中 和 输出。 我 们 不 太 期 望 信息 通过 
参数 输出 。 所 以 ， 输 出 参数 往往 让 人 苗 思 之 后 才 懂 然 大 悟 。 

相 较 于 没有 参数 ， 只 有 一 个 输入 参数 算是 第 二 好 的 做 法 。 
SetupTeardownInclude.render (pageData) 也 相当 易于 理解 。 很 明显 ， 我 
们 将 演 染 pageData 对 象 中 的 数据 。 





问 函 数 传 入 单个 参数 有 两 种 极 普 遍 的 理由 。 你 也 许 会 问 关 于 那个 参 
数 的 问题 ， 就 像 在 boolean fileExists("MyFile) 中 那样 。 也 可 能 是 操作 该 
参数 ， 将 其 转换 为 其 他 什么 东西 ， 再 输出 之 。 例 如 ，InputStream 
fileOpen("MyFile") 把 String 类 型 的 文件 名 转换 为 InputStream 类 型 的 返回 
值 。 这 束 是 读者 看 到 函数 时 所 期 待 的 东西 。 你 应 当选 用 较 能 区 别 这 两 种 
理由 的 名 称 ， 而 且 总 在 一 致 的 上 下 文中 使 用 这 两 种 形式 。 

还 有 一 种 虽 不 那么 普 裔 但 仍 极 有 用 的 单 参 数 函 数 形式 ， 那 就 是 事件 

(event) 。 在 这 种 形式 中 ， 有 输入 参数 而 无 输出 参数 。 程 序 将 函数 看 作 

是 一 个 事件 ， 使 用 该 参数 修改 系统 状态 ， 例 如 void 
passwordAttemptFailedNtimes(int _ attempts)。 小 心 使 用 这 种 形式 。 应 该 让 
读者 很 清楚 地 了 解 它 是 个 事件 。 谨 慎 地 选用 名 称 和 和 上下文 语 境 。 

尽量 避免 编写 不 遵循 这 些 形式 的 一 元 函数 ， 例 如 ，void 
includeSetupPageInto(StringBuffer pageText)。 对 于 转换 ， 使 用 输出 参数 
而 非 返 回 值 令 人 迷惑 。 如 果 函 数 要 对 输入 参数 进行 转换 操作 ， 转 换 结 
就 该 体现 为 返回 值 。 实 际 上 ，StringBuffer transform(StringBuffer in) 要 比 
void transform(StringBuffer out) 强 ， 即 便 第 一 种 形式 只 简单 地 返回 输 参 数 


也 是 这 样 。 至 少 ， 它 遵循 了 转换 的 形式 。 
3.6.2 标识 参数 


标识 参数 丑陋 不 堪 。 回 函数 传 入 布尔 值 简 直 就 是 马 人 听闻 的 做 法 。 
这 样 做 ， 方 法 签名 立刻 变 得 复杂 起 来 ， 大 声 宣 布 本 函数 不 止 做 一 件 事 。 
如 果 标 识 为 true 将 会 这 样 做 ， 标 识 为 false 则 会 那样 做 ! 

在 代码 清单 3-7 中 ， 我 们 别 无 选择 ， 因 为 调用 者 已 经 传 入 了 那个 标 
识 ， 而 我 想 把 重 构 范 围 限 制 在 该 函数 及 该 函数 以 下 范围 之 内 。 方 法 调用 
render(true) 对 于 可 怜 的 读者 来 说 仍然 摸 不 着 头脑 。 卷 动 屏 幕 ， 看 到 
render(Boolean isSuite)， 稍 许 有 点 帮助 ， 不 过 仍然 不 够 。 应 该 把 该 函数 
一 分 为 二 : reanderForSuite( ) 和 renderForSingleTest( )。 








3.6.3 TCP X 


WAT ASIN ERE EE ee BEE. MU, writeField(name)tt 
writeField(outputStream,name)[10] 好 懂 。 

尽管 两 种 情况 下 意义 都 很 清楚 ， 但 第 一 个 只 要 扫 一 眼 就 明白 ， 更 好 
地 表达 了 其 意义 。 第 二 个 就 得 暂停 一 下 才能 明白 ， 除 非 我 们 学 会 包 略 第 
一 个 参数 。 而 且 最 终 那 也 会 导致 问题 ， 因 为 我 们 根本 就 不 该 忽略 任何 代 
人 码 。 忽 略 挥 的 部 分 束 是 缺陷 藏 喘 之 地 。 

当然 ， 有 些 时 候 两 个 参数 正好 。 例 如 ，Point p = new Point(0,0); 残 相 
当 合理 。 稍 卡 儿 点 天 生 拥 有 两 个 参数 。 如 果 看 到 new Point(0)， 我 们 会 倍 
感 惊讶 。 然 而 ， 本 例 中 的 两 个 参数 却 只 是 单个 值 的 有 序 组 成 部 分 ! 而 
output-Stream 和 name 则 既 非 自然 的 组 合 ， 也 不 是 自然 的 排序 。 

即便 是 如 assertEquals(expected, actual) 这 样 的 二 元 函数 也 有 其 问 
题 。 你 有 多 少 次 会 搞 错 actual 和 expected 的 位 置 呢 ? 这 两 个 参数 没有 自然 
的 顺序 。expected 在 前 ，actual 在 后 ， 只 是 一 种 需要 学 习 的 约定 罢了 。 








二 元 函数 不 算 恶 劣 ， 而 且 你 当然 也 会 编写 二 元 函数 。 不 过 ， 你 得 小 
心 ， 使 用 二 元 函数 要 付出 代价 。 你 应 该 尽量 利用 一 些 机 制 将 其 转换 成 一 
元 函数 。 例 如 ， 可 以 把 writeField 方法 写成 outputStream 的 成 员 之 一 ， 从 
而 能 这 样 用 : outputStream.writeFieldOname)。 或 者 ， 也 可 以 把 
outputStream 写 成 当前 类 的 成 员 变 量 ， 从 而 无 需 再 传递 它 。 还 可 以 分 离 
出 类 似 FieldWriter 的 新 类 ， 在 其 构造 器 中 采用 outputStream， 并 且 包 售 
一 个 write 方法 。 





3.6.4 = 7L ER Z 


有 三 个 参数 的 函数 要 比 二 元 函数 难 懂得 多 。 排 序 、 琢 磨 、 忽 略 的 问 
题 都 会 加 倍 体 现 。 建 议 你 在 写 三 元 函数 前 一 定 要 想 清楚 。 

例如 ， 设 想 assertEquals 有 三 个 参数 : assertEquals(message, expected, 
actual)。 有 多 少 次 ， 你 读 到 message， 错 以 为 它 是 expected 呢 ? FRI T E 
在 这 个 三 元 函数 上 。 实 际 上 ， 每 次 我 看 到 这 里 ， 总 会 绕 半 天 圈子 ， 最 后 
学 会 了 忽略 message 参 数 。 

另 一 方面 ， 这 里 有 个 并 不 那么 险恶 的 三 元 函数 : assertEquals(1.0, 
amount，.001)。 虽 然 也 要 费 点 神 ， 还 是 值得 的 。 得 到 *“ 浮 点 值 的 等 值 是 相 
对 而 言 ” 的 提示 总 是 好 的 。 














3.6.5 SUA 


如 果 函 数 看 来 需要 两 个 、 三 个 或 三 个 以 上 参数 ， 束 说 明 其 中 一 些 参 
数 应 该 封装 为 类 了 。 例 如 ， 下 面 两 个 声明 的 差别 : 


Circle makeCircle(double x, double y, double radius); 





Circle makeCircle(Point center, double radius); 
从 参数 创建 对 象 ， 从 而 减少 参数 数量 ， 看 起 来 像 是 在 作 浆 ， 但 实则 
并 非 如 此 。 当 一 组 参数 被 共同 传递 ， 束 像 上 例 中 的 x 和 y 那 样 ， 往 往 就 是 


该 有 自己 名 称 的 茶 个 概念 的 一 部 分 
3.6.6 参数 列表 


有 时 ， 我 们 想 要 向 函数 传 入 数量 可 变 的 参数 。 例 如 ，String.format 
方法 : 

String.format("%s worked %.2f hours.", name, hours); 

如 果 可 变 参数 像 上 例 中 那样 被 同等 对 待 ， 就 和 类 型 为 List 的 单个 参 
数 没什么 两 样 。 这 样 一 来 ，String.formate 实 则 是 二 元 函数 。 下 列 
String.format 的 声明 也 很 明显 是 二 元 的 : 

public String format(String format, Object... args) 

同 理 ， 有 可 变 参 数 的 函数 可 能 是 一 元 、 二 元 甚至 三 元 。 超 过 这 个 数 
量 就 可 能 要 犯错 了 。 

void monad(Integer... args); 

void dyad(String name, Integer... args); 


void triad(String name, int count, Integer... args); 








3.6.7 动词 与 关键 字 


给 函数 取 个 好 名 字 ， 能 较 好 地 解释 函数 的 意图 ， 以 及 参数 的 顺序 和 
意图 。 对 于 一 元 函数 ， 函 数 和 参数 应 dea 民 好 的 动词 /名 词 
对 形式 。 例 如 ，write(name) 就 相当 令 人 认同 。 不 管 I ， 
都 要 被 “write"”。 更 好 的 名 称 大 概 是 writeFieldname)， 它 告诉 我 
们 ，“name” 是 一 个 “field”。 

最 后 那个 例子 展示 了 函数 名 称 的 关键 字 (keyword) 形式 。 使 用 这 
种 形式 ， 我 们 把 参数 的 名 称 编码 成 了 函数 名 。 例 如 ， ss 
assertExpectedEqualsActual(expected, actual) 可 能 会 好 些 。 这 大 大 减轻 了 


记忆 参数 顺序 的 负担 。 


3.7 KH 


RIE ae ATI ZUR HIC TES. (PREME E 
来 的 事 。 有 时 ， 它 会 对 自己 类 中 的 变量 做 出 未 能 预期 的 改动 。 有 时 ， 它 
会 把 变量 搞 成 回 函 数 传递 的 参数 或 是 系统 全 局 变量 。 无 论 哪 种 情况 ， 都 
是 具有 破坏 性 的 ， 会 导致 古怪 的 时 序 性 粳 合 及 顺序 依赖 。 

以 代码 清单 3-6 中 看 似 无 伤 大 雅 的 函数 为 例 。 该 函数 使 用 标准 算法 
来 匹配 userName 和 password。 如 果 匹 配 成 功 ， 返 回 true， 如 果 失 败 则 返 
回 false。 但 它 会 有 副作用 。 你 知道 问题 所 在 吗 ? 

代码 清单 3-6 UserValidator.java 

public class UserValidator { 





private Cryptographer cryptographer; 
public boolean checkPassword(String userName, String password) { 
User user = UserGateway.findByName(userName); 
if (user != User.NULL) { 
String codedPhrase = user.getPhraseEncodedByPassword(); 
String phrase = cryptographer.decrypt(codedPhrase, password); 
if ("Valid Password".equals(phrase)) { 
Session.initialize(); 


return true; 


} 


return false; 


} 

当然 了 ， 副 作用 就 在 于 对 Session.initialize( ) 的 调用 。checkPassword 
函数 ， 顾 名 思 义 ， 就 是 用 来 检查 密码 的 。 该 名 称 并 未 暗示 它 会 初始 化 该 
次 会 话 。 所 以 ， 当 某 个 误 信 了 函数 名 的 调用 者 想 要 检查 用 户 有 效 性 时 ， 
就 得 冒 抹 除 现 有 会 话 数据 的 风险 。 

这 一 副作用 造 出 了 一 次 时 序 性 耘 合 。 也 就 是 说 ，checkPassword 只 能 
在 特定 时 刻 调用 《换言之 ， 在 初始 化 会 话 是 安全 的 时 候 调 用 ) 。 如 果 在 
不 合适 的 时 候 调 用 ， 会 话 数据 就 有 可 能 沉默 地 丢失 。 时 序 性 碍 合 令 人 迷 
惑 ， 特 别 是 当 它 躲 在 副作用 后 面 时 。 如 果 一 定 要 时 序 性 耦合 ， 束 应 该 在 
函数 名 称 中 说 明 。 在 本 例 中 ， 可 以 重 命名 函数 为 
checkPasswordAndInitializeSession， 虽 然 那 还 是 违反 了 “只 做 一 件 事 ”的 
规则 。 

输出 参数 

参数 多 数 会 被 目 然 而 然 地 看 作 是 函数 的 输入 。 如 果 你 编 过 好 些 年 程 
序 ， 我 担保 你 一 定 被 用 作 输 出 而 非 输入 的 参数 迷惑 过 。 例 如 : 

appendFooter(s); 

这 个 函数 是 把 s 添 加 到 什么 东西 后 面 吗 ?或 者 它 把 什么 东西 添加 到 
fs? s 是 输入 参数 还 是 输出 参数 ? 稍 许 花 点 时 间 看 看 函数 签名 : 

public void appendFooter(StringBuffer report) 

事情 清楚 了 ， 但 付出 了 检查 函数 声明 的 代价 。 你 极 迫 检查 函数 签 
名 ， 就 得 花 上 一 点 时 间 。 应 该 避免 这 种 中 断 思 路 的 事 。 

在 面 癌 对 象 编程 之 前 的 岁月 里 ， 有 时 的 确 需要 输出 参数 。 然 而 ， 面 
问 对 象 语言 中 对 输出 参数 的 大 部 分 需求 已 经 消失 了 ， 因 为 this 也 有 输出 
函数 的 意味 在 内 。 换 言 之 ， 最 好 是 这 样 调用 appendFooter: 

report.appendFooter(); 

普遍 而 言 ， 应 避免 使 用 输出 参数 。 如 果 函 数 必须 要 修改 某 种 状态 ， 
束 修 改 所 属 对 象 的 状态 吧 。 

















3.8 分 隔 指令 与 询问 





函数 要 么 做 什么 事 ， 要 么 回答 什么 事 ， 但 二 者 不 可 得 兼 。 函 数 应 该 
修改 某 对 象 的 状态 ， 或 是 返回 该 对 象 的 有 关 信 息 。 两 样 都 干 常会 导致 混 
乱 。 看 看 下 面 的 例子 : 

public boolean set(String attribute, String value); 

该 函数 设置 某 个 指定 属性 ， 如 采 成 功 融 返回 true， 如 果 不 存 在 那个 
属性 则 返回 false。 这 样 就 导致 了 以 下 语句 : 

if (set("username", "unclebob"))... 

从 读者 的 角度 考虑 一 下 吧 。 这 是 什么 意思 呢 ? 它 是 在 问 username 属 
性 值 是 否 之 前 已 设置 为 unclebob 吗 ? 或 者 它 是 在 问 username 属 性 值 是 否 
成 功 设 置 为 unclebob 呢 ? 从 这 行 调用 很 难 判断 其 含义 ， 因 为 set 是 动词 还 
是 形容 词 并 不 清楚 。 

作者 本 意 ，set 是 个 动词 ， 但 在 让 语句 的 上 下 文中 ， 感 觉 它 像 是 个 形 
容 词 。 该 语句 读 起 来 像 是 说 “如 果 username 属 性 值 之 前 已 被 设置 为 
uncleob”， 而 不 是 “设置 username 属 性 值 为 unclebob， 看 看 是 否 可 行 ， 然 
后 .…...”。 要 解决 这 个 问题 ， 可 以 将 set 函数 重 命名 为 
setAndCheckIfExists， 但 这 对 提高 if 语句 的 可 读 性 帮助 不 大 。 真 正 的 解 
决 方案 是 把 指令 与 询问 分 隔 开 来 ， 防 止 混 消 的 发 生 : 


if (attributeExists("username")) { 








setAttribute("username", "unclebob"); 








Mia seh BO RE SHAS 3 VII A. "Eu 
励 了 在 让 语句 判断 中 把 指令 当 作 表达 式 使 用 。 
if (deletePage(page) == E_OK) 
这 不 会 引起 动词 /形容 词 混 消 ， 但 却 导 致 更 深层 次 的 内 套 结构 。 当 
返回 错误 码 时 ， 就 是 在 要 求 调用 者 立刻 处 理 错误 。 
if (deletePage(page) == E_OK) { 
if (registry.deleteReference(page.name) == E_OK) { 
if (configKeys.deleteKey(page.name.makeKey()) == E_OK){ 
logger.log("page deleted"); 
} else { 
logger.log("configKey not deleted"); 
} 
} else { 
logger.log("deleteReference from registry failed"); 
} 
} else { 
logger.log("delete failed"); 
return E. ERROR; 
} 
另 一 方面 ， 如 果 使 用 异常 蔡 代 返回 错误 码 ， 错 误 处 理 代 码 就 能 从 主 
路 径 代 码 中 分 离 出 来 ， 得 到 简化 : 
try { 


deletePage(page); 
registry.deleteReference(page.name); 
configKeys.deleteKey(page.name.makeKey()); 
} 
catch (Exception e) { 
logger.log(e.getMessage()); 


3.9.1 th A Try/Catch{t 1X 


Try/catch 代 码 块 丑陋 不 堪 。 它 们 搞 乱 了 代码 结构 ， 把 错误 处 理 与 正 
常 流程 混为一谈 。 最 好 把 try 和 catch 代 码 块 的 主体 部 分 抽 离 出 来 ， 另 外 
形成 函数 。 
public void delete(Page page) { 
try { 
deletePageAndAllReferences(page); 
i 
catch (Exception e) 1 
logError(e); 


j 
private void deletePageAndAllReferences(Page page) throws Exception 


deletePage(page); 
registry.deleteReference(page.name); 


configKeys.deleteKey(page.name.makeKey()); 


private void logError(Exception e) { 
logger.log(e.getMessage()); 
} 
在 上 例 中 ，delete 函 数 只 与 错误 处 理 有 关 。 很 容易 理解 然后 就 忽略 
$8. deletePageAndAllReferencerA Zi R 5; EMR —- page AR. TVA 
处 理 可 以 忽略 掉 。 有 了 这 样 美妙 的 区 隅 ， 代 码 融 更 易于 理解 和 修改 了 。 


3.9.2 错误 处 理 束 是 一 


AE 件 事 。 错 误 处 理 束 是 一 件 事 。 因 此 ， 处 理 错误 的 函 
数 不 该 做 其 他 事 。 这 意味 着 〈 如 上 例 所 示 ) 如果 关 键 字 try 在 某 个 函数 中 
存在 ， 它 就 该 是 这 个 函数 的 第 一 个 单词 ， 而 且 在 catchyfinally 代 码 块 后 面 
也 不 该 有 其 他 内 容 。 











3.9.3 Error. javak wi [4 








返回 错误 码 通 党 暗示 茶 处 有 个 类 或 是 枚 举 ， 定 义 了 所 有 错误 码 。 
public enum Error { 
OK, 
INVALID, 
NO_SUCH, 
LOCKED, 
OUT_OF_RESOURCES, 
WAITING FOR_EVENT; 
} 
这 样 的 类 就 是 一 块 依赖 磁铁 (dependency magnet) ; 其 他 许多 类 都 
得 导入 和 使 用 它 。 当 Error 枚 举 修改 时 ， 所 有 这 些 其 他 的 类 都 需要 重新 编 
译 和 部 署 。[11] 这 对 Error 类 造成 了 负面 压力 。 程 序 员 不 愿 增加 新 的 错误 


代码 ， 因 为 这 样 他 们 就 得 重新 构建 和 部 署 所 有 东西 。 于 是 他 们 就 复 用 旧 
的 错误 码 ， 而 不 添加 新 的 。 

使 用 异常 丛 代 错误 码 ， 新 异常 就 可 以 从 寞 第 类 派生 出 来 ， 无 需 重 新 
编译 或 重新 部 署 [12]。 





3.10 ITER A 


u3] 

回头 仔细 看 看 代码 清单 3-1， 你 会 注意 到 ， 有 个 算法 在 SetUp、 
SuiteSetUp、TearDown 和 SuiteTearDown 中 总 共 被 重复 了 4 次 。 识 别 重复 
不 太 容 易 ， 因 为 这 4 次 重复 与 其 他 代码 混在 一 起 ， 而 且 也 不 完全 一 样 。 
这 样 的 重复 还 是 会 导致 问题 ， 因 为 代码 因此 而 豚 肿 ， 且 当 算 法 改变 时 需 
要 修改 4 处 地 方 。 而 且 也 会 增加 4 次 放 过 错误 的 可 能 性 。 
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使 用 代码 清单 3-7 中 的 ipclude 方 法 修正 了 这 些 重复 。 再 读 一 过 那 段 
代码 ， 你 会 注意 到 ， 整 个 模块 的 可 读 性 因为 重复 的 消除 而 得 到 了 提升 。 
重复 可 能 是 软件 中 一 切 收 恶 的 根源 。 许 多 原则 与 实践 规则 都 是 为 控 


制 与 消除 重复 而 创建 。 例 如 ， 全 部 考 德 〈Codd) [14] 数 据 库 范式 都 是 为 
消灭 数据 重复 而 服务 。 再 想 想 看 ， 面 向 对 象 编程 是 如 何 将 代码 集中 到 基 
类 ， 从 而 避免 了 见 余 。 面 同方 面 编程 (Aspect Oriented 
Programming) 、 面 向 组 件 编程 (Component Oriented Programming) 多 
少 也 都 是 消除 重复 的 一 种 策略 。 看 来 ， 自 子 程 序 发 明 以 来 ， 软 件 开发 领 
域 的 所 有 创新 都 是 在 不 断 答 试 从 源 代 码 中 消灭 重复 。 














3.11 结构 化 编程 


有 些 程序 员 遵 循 Edsger ” Dijkstra 的 结构 化 编程 规则 [15]。Dijkstra 认 
为 ， 每 个 函数 、 函 数 中 的 每 个 代码 块 都 应 该 有 一 个 入 口 、 一 个 出 口 。 兰 
循 这 些 规 则 ， 意 味 着 在 每 个 函数 中 只 该 有 一 个 return 语 句 ， 循 环 中 不 能 
有 break 或 continue 语 句 ， 而 且 永 永远 远 不 有 gine 

3l EE HQ TCR REUS HAI, 但 对 于 小 函数 ， 这 些 规 则 助 益 
不 大 。 只 有 在 大 函数 中 ， 这 些 规则 才 会 有 明显 的 好 处 。 

所 以 ， 只 要 函数 保持 短小 ， 偶 尔 出 现 的 return、break 或 continue 语 句 
没有 坏处 ， 甚 至 还 比 单 入 单 出 原则 更 具有 表达 力 。 另 外 一 方面 ，goto 只 
在 大 函数 中 才 有 道理 ， 所 以 应 该 尽量 避免 使 用 。 

















写 代 码 和 写 别 的 东西 很 像 。 在 写 论文 或 文章 时 ， 你 先 想 什 么 就 写 什 
4. AGENTE DIRETTA, PRO HE, EIA BL 
目 中 的 样子 。 

我 写 函 数 时 ， 一 开始 部 见长 而 复杂 。 有 太 多 缩 进 和 购 伍 循环 。 有 过 
长 的 参数 列表 。 名 称 是 随意 取 的 ， 也 会 有 重复 的 代码 。 不 过 我 会 配 上 一 
Chi, Eu HIA KARI 

然后 我 打磨 这 些 代码 ， 分 解 函 数 、 修 改名 称 、 消 除 重复 。 我 缩短 和 
重新 安置 方法 。 有 时 我 还 拆散 类 。 同 时 保持 测试 通过 。 

最 后 ， 萤 循 本 章 列 出 的 规则 ， 我 组 装 好 这 些 函 数 。 

我 并 不 从 一 开始 就 按 照 规则 写 函 数 。 我 想 没 人 做 得 到 。 








3.13 小 结 





每 个 系统 都 是 使 用 茶 种 领域 特定 语言 搭建 ， 而 这 种 语言 是 程序 员 设 
计 来 描述 那个 系统 的 。 函 数 是 语言 的 动词 ， 类 是 名 词 。 这 并 非 是 退回 到 
那 种 认为 需求 文档 中 的 名 词 和 动词 束 是 系统 中 类 和 函数 的 最 初 设想 的 可 
怕 的 旧 观 念 。 其 实 这 是 个 历史 更 久 的 真理 。 编 程 艺术 是 且 一 直 就 是 语言 
设计 的 艺术 。 

大 师 级 程序 员 把 系统 当 作 故事 来 讲 ， 而 不 是 当 作 程序 来 写 。 他 们 使 
用 选 定编 程 语言 提供 的 工具 构建 一 种 更 为 丰富 且 更 具 表 达 力 的 语言 ， 用 
来 讲 那个 故事 。 那 种 领域 特定 语言 的 一 个 部 分 ， 就 是 描述 在 系统 中 发 生 
的 各 种 行为 的 函数 层级 。 在 一 种 狐 独 的 递归 操作 中 ， 这 些 行为 使 用 它们 
定义 的 与 领域 紧密 相关 的 语言 讲述 自己 那个 小 故事 。 

本 章 所 讲述 的 是 有 关 编 写 良 好 函数 的 机 制 。 如 果 你 遵循 这 些 规 则 ， 
RBA), AMPA, MASUR. xb edo. A 
正 的 目标 在 于 讲述 系统 的 故事 ， 而 你 编写 的 函数 必须 干净 利落 地 拼 闭 到 
一 起 ， 形 成 一 种 精确 而 清晰 的 语言 ， 帮 助 你 讲 故事 。 


























3.14 SetupTeardownIncludertt Ý 


代码 清单 3-7 SetupTeardownIncluder.java 
package fitnesse.html; 
import fitnesse.responders.run.SuiteResponder; 
import fitnesse.wiki.*; 
public class SetupTeardownIncluder { 
private PageData pageData; 
private boolean isSuite; 
private WikiPage testPage; 
private StringBuffer newPageContent; 
private PageCrawler pageCrawler; 
public static String render(PageData pageData) throws Exception 1 


return render(pageData, false); 


public static String render(PageData pageData, boolean isSuite) 
throws Exception 1 
return new SetupTeardownIncluder(pageData).render(isSuite); 
j 
private SetupTeardownIncluder(PageData pageData) 1 
this.pageData = pageData; 
testPage = pageData.getWikiPage(); 
pageCrawler = testPage.getPageCrawler(); 


newPageContent = new StringBuffer(); 


} 
private String render(boolean isSuite) throws Exception { 
this.isSuite = isSuite; 
if (isTestPage()) 
includeSetupAndTeardownPages(); 
return pageData.getHtml(); 
} 
private boolean isTestPage() throws Exception { 
return pageData.hasAttribute("Test"); 
} 
private void includeSetupAndTeardownPages() throws Exception { 
includeSetupPages(); 
includePageContent(); 
includeTeardownPages(); 
updatePageContent(); 
} 
private void includeSetupPages() throws Exception { 
if (isSuite) 
includeSuiteSetupPage(); 
includeSetupPage(); 
} 
private void includeSuiteSetupPage() throws Exception { 
include(SuiteResponder.SUITE SETUP NAME, "-setup"); 
j 
private void includeSetupPage() throws Exception { 


include(" SetUp", "-setup"); 


private void includePageContent() throws Exception { 
newPageContent.append(pageData.getContent()); 
} 
private void includeTeardownPages() throws Exception { 
includeTeardownPage(); 
if (isSuite) 
includeSuiteTeardownPage(); 
} 
private void includeTeardownPage() throws Exception { 
include("TearDown", "-teardown"); 
} 
private void includeSuiteTeardownPage() throws Exception { 
include(SuiteResponder.SUITE_TEARDOWN_NAME, "- 
teardown"); 
} 
private void updatePageContent() throws Exception { 
pageData.setContent(newPageContent.toString()); 
} 
private void include(String pageName, String arg) throws Exception { 
WikiPage inheritedPage = findInheritedPage(pageName); 
if (inheritedPage != null) { 
String pagePathName = getPathNameForPage(inheritedPage); 
buildIncludeDirective(pagePathName, arg); 


} 
private WikiPage  findInheritedPage(String pageName) throws 


Exception { 


return PageCrawlerImpl.getInheritedPage(pageName, testPage); 
} 


private String getPathNameForPage(WikiPage page) throws 
Exception { 


WikiPagePath pagePath = pageCrawler.getFullPath(page); 
return PathParser.render(pagePath); 
} 


private void buildIncludeDirective(String pagePathName, String arg) 


newPageContent 
-append("\n! include ") 
.append(arg) 

.append(" .") 
.append(pagePathName) 
.append("\n"); 
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DLE: 一 种 开源 测试 工具 。 见 http://www .fitnese.org。 
[21. 原 注 : 一 种 开源 Java 单 元 测试 工具 。 见 http://www.junit.org。 


BIRRE: 我 问 肯特 是 舍 还 保留 这 段 程 序 ， 他 说 找 不 到 了 。 我 搜 志 自己 
的 电脑 也 没 找到 。 现 在 只 有 在 记忆 中 有 这 上 段 程序 了 。 


[41. 原 注 : LOGO 语 言 中 的 TO 关键 字 ， 与 Ruby 和 Python 中 def 关 键 字 的 用 
法 一 致 。 所 以 ， 每 个 函数 都 以 TO 起 头 。 这 对 函数 的 设计 产生 了 有 趣 的 
影响 。 

[51. 原 注 : [KP78]. 

(6. JRE: 当然 ， 这 也 包括 if/else 语 句 在 内 。 


[7]. 原 注 : a. http://en.wikipedia.org/wiki/Single_responsibility_principle; b. 
http:/www.objectmentor.com/resources/articles/srp.pdf。 


[8]. 原 注 : a. http://en.wikipedia.org/wiki/Open/closed_principle; b. 
http://www.objectmentor.com/resources/articles/ocp.pdf - 


[91. 原 注 : [GOF]. 

[0]1. 原 注 : 我 刚 重 构 了 一 个 使 用 了 二 元 形式 的 模块 。 现 在 就 能 把 
outputStream 做 成 该 类 的 一 个 字段 ， 并 把 所 有 对 writeField 的 调用 都 变 作 
—JUEx. ARRAS I 
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[121. 原 注 : 这 也 是 开放 闭合 原则 COCPO 的 一 个 范例 [PPPO2]. 
[13]. 原 注 : DRY 原 则 。[PRAG]。 

[141. 译 注 : 艾 德 加 :F: 考 德 (Edgar F. Codd) ， 关 系数 据 库 之 父 。 
[15]. 3€: [SP72]. 








“ 别 给 糟糕 的 代码 加 注释 一 一 重新 写 吧 。” 
Brian W. Kernighan SP. J. Plaugher[1] 

什么 也 比 不 上 放置 展 好 的 注释 来 得 有 用 。 什 么 也 不 会 比 乱七八糟 的 
注释 更 有 本 事 搞 乱 一 个 模块 。 什 么 也 不 会 比 陈旧 、 提 供 错误 信息 的 注释 
更 有 破坏 性 。 

注释 并 不 像 辛 德 勒 的 名 里。 它们 并 不 “ 纯 然 地 好 ”。 实 际 上 ， 注 释 最 
多 也 就 是 一 种 必须 的 悉 。 寿 编程 语言 足够 有 表达 力 ， 或 者 我 们 长 于 用 这 
些 语言 来 表达 意图 ， 就 不 那么 需要 注释 一 一 也 许 根 本 不 需要 。 

注释 的 恰当 用 法 是 弥补 我 们 在 用 代码 表达 意图 时 遭遇 的 失败 。 注 
意 ， 我 用 了 “失败 ”一 词 。 我 是 说 真 的 。 注 释 总 是 一 种 失败 。 我 们 总 无 法 
找到 不 用 注释 就 能 表达 自我 的 方法 ， 所 以 总 要 有 注释 ， 这 并 不 值得 庆 
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如 果 你 发 现 自己 需要 写 注释 ， 再 想 想 看 是 否 有 办 法 翻盘 ， 用 代码 来 
表达 。 每 次 用 代码 表达 ， 你 都 该 守 奖 一 下 自己 。 每 次 写 注释 ， 你 都 该 做 
个 鬼脸 ， 感 受 自己 在 表达 能 力 上 的 失败 。 








RATA BAM TIRE RE? 因为 注释 会 撒谎 。 也 不 是 说 总 是 如 此 或 
有 意 如 此 ， 但 出 现 得 实在 太 频 繁 。 注 释 存 在 的 时 间 越 入 ， 就 离 其 所 描述 
的 代码 越 远 ， 越 来 越 变 得 全 然 错误 。 原 因 很 简单 。 程 序 员 不 能 坚持 维护 
注释 。 
代码 在 变动 ， 在 演化 。 从 这 里 移 到 那里 。 役 此 分 离 、 重 造 又 合 到 一 
处 。 很 不 位， 注释 并 不 总 是 随 之 变动 一 ABE ERE TERRA 
与 其 所 描述 的 代码 分 隔 开 来 ， 子 然 球 零 ， 越 来 越 不 准确 。 例 如 ， 看 看 以 
下 注释 以 及 它 本 来 要 描述 的 代码 行 变 成 了 什么 样子 : 
MockRequest request; 
private final String HTTP_DATE_REGEXP = 
"[ISMTWF][a-z]{2}\\,\\s[0-9]{2}\\s.[JFMASOND][a-z]{2}\\s"+ 
"[0-9]{4}\\s[0-9]{2}\\:[0-9]{2}\\:[0-9]{2}\\sSGMT"; 


private Response response; 








private FitNesseContext context; 

private FileResponder responder; 

private Locale saveLocale; 

// Example: "Tue, 02 Apr 2003 22:18:49 GMT" 

在 HTTP_DATE_REGEXP 常 量 及 其 注释 之 间 ， 有 可 能 插入 其 他 实体 





2 


ral 


程序 员 应 当 负责 将 注释 保持 在 可 维护 、 有 关联 、 精 确 的 高 度 。 我 同 
意 这 种 说 法 。 但 我 更 主张 把 力气 用 在 写 清 楚 代 码 上 ， 直 接 保证 无 须 编 号 
注释 。 

不 准确 的 注释 要 比 没 注释 坏 得 多 。 它 们 满口 胡言 。 它 们 预期 的 东西 
水 不 能 实现 。 它 们 设 定 了 无 需 也 不 应 再 遵循 的 旧 规 则 。 

真实 只 在 一 处 地 方 有 : 代码 。 只 有 代码 能 忠实 地 告诉 你 它 做 的 事 。 
那 是 唯一 真正 准确 的 信息 来 源 。 所 以 ， 尽 管 有 时 也 需要 注释 ， 我 们 也 该 
多 花心 思 尽 量 减 少 注释 量 。 











IERI S GSP VL ARTI CAS IEEE RAME AR, 
RIVERA. ALC). RIMANE, CEET. RIEA 
Di “We, fed ERE! ”不 ! 最 好 是 把 代码 弄 干 净 ! 

带 有 少量 注释 的 整洁 而 有 表达 力 的 代码 ， 要 比 珊 有 大 量 注 释 的 零 他 
而 复 休 的 代码 像样 得 多 。 与 其 伦 时 间 编 写 解释 你 搞 出 的 糟糕 的 代码 的 注 
释 ， 不 如 花 时 间 清 洁 那 堆 糟糕 的 代码 。 
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为 代码 很 少 一 一 如 果 有 的 话 做 好 解释 工作 。 这 种 观点 纯 属 错误 。 
你 愿意 看 到 这 个 : 


// Check to see if the employee is eligible for full benefits 
if ((employee.flags & HOURLY FLAG) && 
(employee.age > 65)) 
还 是 这 个 ? 
if (employee.isEligibleForFullBenefits()) 
只 要 想 上 那么 几 秒 钟 ， 就 能 用 代码 解释 你 大 部 分 的 意图 。 很 多 时 
候 ， 简 单 到 只 需要 创建 一 个 描述 与 注释 所 言 同 一 事物 的 函数 即 可 。 


有 些 注释 是 必须 的 ， 也 是 有 利 的 。 来 看 看 一 些 我 认为 值得 写 的 注 
释 。 不 过 要 记 住 ， 唯 一 真正 好 的 注释 是 你 想 办 法 不 去 写 的 注释 。 











有 了 时， 公司 代码 规范 要 求 编写 与 法 律 有 关 的 注释 。 例 如 ， 版 权 及 著 
作 权 声明 融 是 必须 和 有 理由 在 每 个 源 文 件 开头 注释 处 放置 的 内 容 。 

下 例 是 我 们 在 FitNesse 项 目 每 个 源 文件 开头 放置 的 标准 注释 。 我 可 
以 很 开心 地 说 ，IDE 自 动 卷 起 这 些 注释 ， 这 样 就 不 会 显得 凌乱 了 。 

// Copyright (C) 2003,2004,2005 by Object Mentor, Inc. All rights 


reserved. 





// Released under the terms of the GNU General Public License version 
2 or later. 

这 类 注释 不 应 是 合同 或 法 典 。 只 要 有 可 能 ， 就 指 同一 份 标准 许可 或 
其 他 外 部 文档 ， 而 不 要 把 所 有 条 款 放 到 注释 中 。 














有 时 ， 用 注释 来 提供 基本 信息 也 有 其 用 处 。 例 如 ， 以 下 注释 解释 了 
某 个 抽象 方法 的 返回 值 : 

// Returns an instance of the Responder being tested. 

protected abstract Responder responderInstance(); 

这 类 注释 有 时 管用 ， 但 更 好 的 方式 是 尽量 利用 函数 名 称 传达 信息 。 
比如 ， 在 本 例 中 ， 只 要 把 函数 重新 命名 为 responderBeingTested， 注 释 吏 





是 多 余 的 了 。 

下 例 稍 好 一 些 : 

// format matched kk:mm:ss EEE, MMM dd, yyyy 

Pattern timeMatcher = Pattern.compile( 

"\\d*:\\d*:\\d* \\w*, \\w* \\d*, \\d*"); 

在 本 例 中 ， 注 释 说 明 ， 该 正则 表达 式 意 在 匹配 一 个 经 由 
SimpleDateFormat.format 函 数 利 用 特定 格式 字符 串 格 式 化 的 时 间 和 日 
期 。 同 样 ， 如 果 把 这 段 代 码 移 到 茶 个 转换 日 期 和 时 间 格 式 的 类 中 ， 就 会 
更 好 、 更 清晰 ， 而 注释 也 就 变 得 多 此 一 举 了 。 


4.3.3 对 意图 的 解释 


有 时 ， 注 释 不 仅 提供 了 有 关 实 现 的 有 用 信息 ， 而 且 还 提供 了 某 个 决 
定 后 面 的 意图 。 在 下 例 中 ， 我 们 看 到 注释 反映 出 来 的 一 个 有 趣 决 是。 在 
对 比 两 个 对 象 时 ， 作 者 决定 将 他 的 类 放置 在 比 其 他 东西 更 高 的 位 置 。 
public int compareTo(Object 0) 
{ 
if(o instanceof WikiPagePath) 
{ 
WikiPagePath p = (WikiPagePath) o; 
String compressedName = StringUtil.join(names, ""); 
String compressedArgumentName = StringUtil.join(p.names, ""); 
return compressedName.compareTo(compressedArgumentName); 
} 
return 1; // we are greater because we are the right type. 
} 
下 面 的 例子 甚至 更 好 。 你 也 许 不 同意 程序 员 给 这 个 问题 提供 的 解决 








方案 ， 但 至 少 你 知道 他 想 干 什么 。 
public void testConcurrentAddWidgets() throws Exception { 
WidgetBuilder widgetBuilder = 
new WidgetBuilder(new Class[]{BoldWidget.class}); 
String text = """bold text"; 
ParentWidget parent = 
new BoldWidget(new MockWidgetRoot(), "bold text"); 
AtomicBoolean failFlag = new AtomicBoolean(); 
failFlag.set(false); 
//This is our best attempt to get a race condition 
//by creating large number of threads. 
for (int i = 0; i < 25000; i++) { 
WidgetBuilderThread widgetBuilderThread = 
new WidgetBuilderThread(widgetBuilder, text, parent, failFlag); 
Thread thread = new Thread(widgetBuilderThread); 
thread.start(); 
} 
assertEquals(false, failFlag.get()); 


4.3.4 [i] E 
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形式 ， 也 会 是 有 用 的 。 通 向， 更 好 的 方法 是 尽量 让 参数 或 返回 值 目 身 就 
足够 清楚 ; 但 如 果 参 数 或 返回 值 是 从 个 标准 库 的 一 部 分 ， 或 是 你 不 能 修 
改 的 代码 ， 帮 助 阐释 其 含义 的 代码 就 会 有 用 。 


public void testCompareTo() throws Exception 





WikiPagePath a = PathParser.parse("PageA"); 

WikiPagePath ab = PathParser.parse("PageA.PageB"); 

WikiPagePath b = PathParser.parse("PageB"); 

WikiPagePath aa = PathParser.parse("PageA.PageA"); 

WikiPagePath bb = PathParser.parse("PageB.PageB"); 

WikiPagePath ba = PathParser.parse("PageB.PageA"); 

assertTrue(a.compareTo(a) == 0); // a == 

assertTrue(a.compareTo(b) != 0); // a != b 

assertTrue(ab.compareTo(ab) == 0); // ab == ab 

assert True(a.compareTo(b) == -1); //a < b 

assertTrue(aa.compareTo(ab) == -1); // aa < ab 

assertTrue(ba.compareTo(bb) == -1); // ba < bb 

assertTrue(b.compareTo(a) == 1); //b> a 

assertTrue(ab.compareTo(aa) == 1); // ab > aa 

assert True(bb.compareTo(ba) == 1); // bb > ba 

} 
当然 ， 这 也 会 冒 曾 释 性 注释 本 里 束 不 正确 的 风险 。 回 头 看 看 上 例 ， 

你 会 发 现 想 要 确认 注释 的 正确 性 有 多 难 。 这 一 方面 说 明了 阐释 有 多 必 
要 ， 另 外 也 说 明了 它 有 风险 。 所 以 ， 在 写 这 类 注释 之 前 ， 考 虑 一 下 是 否 
还 有 更 好 的 办 法 ， 然 后 再 加 倍 小 心地 确认 注释 正确 性 。 





4.3.5 A 





如 ， 下 面 的 注释 解释 了 为 什么 要 关闭 某 个 特定 的 测试 用 例 : 


// Don't run unless you 


有 时 ， 用 于 和 警告 其 他 程序 员 会 出 现 茶 种 后 果 的 注释 也 是 有 用 的 。 例 


// have some time to kill. 
public void _testWithReallyBigFile() 
{ 
writeLinesToFile(10000000); 
response.setBody(testFile); 
response.ready ToSend(this); 
String responseString = output.toString(); 
assertSubString("Content-Length: 1000000000", responseString); 


assertTrue(bytesSent > 1000000000); 

} 

当然 ， 如 今 我 们 多 数 会 利用 附 上 恰当 解释 性 字符 串 的 @Ignore 属性 
来 关闭 测试 用 例 。 比 如 @Ignore("Takes too long to run[2]"). {A#EJUnit4 
之 前 的 日 子 里 ， 惯 常 的 做 法 是 在 方法 名 前 面 加 上 下 划 线 。 如 果 注 释 足 够 
有 说 服 力 ， 就 会 很 有 用 了 。 

这 里 有 个 更 矿 烦 的 例子 : 

public static SimpleDateFormat makeStandardHttpDateFormat() 

{ 


//SimpleDateFormat is not thread safe, 





//so we need to create each instance independently. 
SimpleDateFormat df = new SimpleDateFormat("EEE, dd MMM 
yyyy HH:mm:ss z"); 
df.setTimeZone(TimeZone.getTimeZone("GMT")); 
return df; 
} 
你 也 许 会 抱怨 说 ， 还 会 有 更 好 的 解决 方法 。 我 大 概 会 同意 。 不 过 上 
面 的 注释 绝对 有 道理 存在 ， 它 能 阻止 某 位 急切 的 程序 员 以 效率 之 名 使 用 
DURS GE o 


4.3.6 TODO; f£ 


有 时 ， 有 理由 用 /TODO 形式 在 源 代码 中 放置 要 做 的 工作 列表 。 在 
下 例 中 ，TODO 注释 解释 了 为 什么 该 函数 的 实现 部 分 无 所 作为 ， 将 来 应 
该 是 怎样 。 

//[TODO-MdM these are not needed 


// We expect this to go away when we do the checkout model 


protected VersionInfo makeVersion() throws Exception 

{ 

return null; 

} 

TODO 是 一 种 程序 员 认 为 应 该 做 ， 但 由 于 茶 些 原因 目前 还 没 做 的 工 
fg. EN Reese 除 茶 个 不 必要 的 特性 ， 或 者 要 求 他 人 注意 茶 个 问 
题 。 它 可 能 是 恳请 别人 取 个 好 名 字 ， 或 者 提示 对 依赖 于 某 个 计划 事件 的 
区 改 。 无 论 TODO 的 目的 如 何 ， 它 都 不 是 在 系统 中 留 下 糟糕 的 代码 的 借 
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这 些 注释 看 来 于 不 了 。 你 不 会 愿意 代码 因为 TODO 的 存在 而 变 成 一 堆 垃 
圾 ， 所 以 要 定期 查看， 删除 不 再 需要 的 。 


4.3.7 放大 
注释 可 以 用 来 放大 茶 种 看 来 不 合理 之 物 的 重要 性 。 


String listItemContent = match.group(3).trim(); 








// the trim is real important. It removes the starting 

// spaces that could cause the item to be recognized 

// as another list. 

new ListItemWidget(this, listItemContent, this.level + 1); 
return buildList(text.substring(match.end())); 


4.3.8 AH API I] Javadoc 


没有 什么 比 被 良好 描述 的 公共 API 更 有 用 和 令 人 满意 的 了 。 标 准 
Java 库 中 的 Javadoc 束 是 一 例 。 没 有 它们 ， 写 Java 程 序 束 会 变 得 很 难 。 
如 果 你 在 编写 公共 API， 束 该 为 它 编写 良好 的 Javadoc。 不 过 要 记 住 








本 章 中 的 其 他 建议 。 就 像 其 他 注释 一 样 ，Javadoc 也 可 能 误导 、 不 适用 
或 者 提供 错误 信息 。 


4.4 坏 注 释 
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或 者 对 错误 决策 的 修正 ， 基 本 上 等 于 程序 员 目 说 目 话 。 














如 果 只 是 因为 你 党 得 应 该 或 者 因为 过 程 需 要 惑 添 加 注释 ， 那 就 是 无 





请 之 举 。 如 果 你 决定 写 注释 ， 束 要 论 必要 的 时 间 确 保 写 出 最 好 的 注释 。 


例如 ， 我 在 FitNesse 中 找到 的 这 个 例子 ， 例 中 的 注释 大 概 确实 有 





。 不 过 ， 作 者 太 痢 急 ， 或 者 没 太 花心 思 。 他 的 喃 喃 目 语 变 成 了 一 个 谜 


public void loadProperties() 
{ 
try 
{ 
String propertiesPath = propertiesLocation +  "" + 
PROPERTIES_FILE; 
FileInputStream propertiesStream = new 


FileInputStream(propertiesPath); 
loadedProperties.load(propertiesStream); 
} 
catch(IOException e) 
{ 


// No properties files means all defaults are loaded 


} 

catch 代 码 块 中 的 注释 是 什么 意思 呢 ? 显然 对 于 作者 有 其 意义 ， 不 过 
并 没有 好 到 足够 的 程度 。 很 明显 ， 如 果 出 现 IOException， 就 表示 没有 属 
性 文件 ;在 那 种 情况 下 ， 载 入 默认 设置 。 但 谁 来 装载 默认 设置 呢 ? 会 在 
对 loadProperties.load 之 前 装载 吗 ? 抑或 1oadProperties.load 捕 获 异 常 、 装 
载 默认 设置 、 再 向 上 传递 异常 ? 再 或 1oadProperties.load 在 尝试 载 入 文件 
前 就 装载 所 有 默认 设置 ? 要 么 作者 只 是 在 安慰 上 自己 别 在 意 catch 代码 块 
WAT? 或 者 一 一 这 种 可 能 最 可 怕 一 一 作者 是 想 告 诉 自 己 ， 将 来 再 回头 
写 闭 载 默认 设置 的 代码 ? 

我 们 唯 有 检视 系统 其 他 部 分 的 代码 ， 弄 清 事情 原委 。 任 何 迫使 读者 
租 看 其 他 模块 的 注释 ， 都 没 能 与 读者 沟通 好 ， 不 值 所 帘 。 


442 多 余 的 注释 


代码 清单 4-1 展 示 的 简单 函数 ， 其 头 部 位 置 的 注释 全 属 多 余 。 读 这 
段 注 释 花 的 时 间 没 准 比 读 代 码 花 的 时 间 还 要 长 。 
代码 清单 4-1 waitForClose 


// Utility method that returns when this.closed is true. Throws an 

















exception 
// if the timeout is reached. 
public synchronized void waitForClose(final long timeoutMillis) 
throws Exception 
{ 
if(!closed) 
{ 


wait(timeoutMillis); 


if(!closed) 

throw new Exception("MockResponseSender could not be 
closed"); 

} 

} 

这 段 注释 起 了 什么 作用 ? 它 并 不 能 比 代 码 本 号 提供 更 多 的 信息 。 它 
没有 证 明代 码 的 意义 ， 也 没有 给 出 代码 的 意图 或 逻辑 。 读 它 并 不 比 读 代 
人 码 更 容易 。 事 实 上 ， 它 不 如 代码 精确 ， 误 导读 者 接受 不 精确 的 信息 ， 而 
不 是 正确 地 理解 代码 。 它 就 像 个 自 来 熟 的 二 手 车 贩子 ， 满 口 保证 你 不 用 
打开 发 动机 盖 奉 验 。 

来 看 看 代码 清单 4-2 中 摘自 Tomcat 项 目的 无 用 而 多 余 的 Javadoc 吧 。 
这 些 注释 只 是 一 味 将 代码 搞 得 含糊 不 明 。 完 全 没有 文档 上 的 价值 。 下 面 
只 列 出 了 靠 前 面 的 一 些 代 码 ， 后 续 模 块 中 还 有 许多 类 似 情 况 。 

代码 清单 4-2 ContainerBase.java (Tomcat) 


public abstract class ContainerBase 














implements Container, Lifecycle, Pipeline, 
MBeanRegistration, Serializable { 
[PE 
* The processor delay for this component. 
si 
protected int backgroundProcessorDelay = -1; 
[RK 
* The lifecycle event support for this component. 
*/ 
protected LifecycleSupport lifecycle = 
new LifecycleSupport(this); 


[E 


* The container event listeners for this Container. 
ui 
protected ArrayList listeners = new ArrayList(); 
[PE 
* The Loader implementation with which this Container is 
* associated. 
di; 
protected Loader loader = null; 
[RK 
* The Logger implementation with which this Container is 
* associated. 
ui 
protected Log logger = null; 
[PE 
* Associated logger name. 
"f 
protected String logName - null; 
[PE 
* The Manager implementation with which this Container is 
* associated. 
*/ 
protected Manager manager = null; 
[PE 
* The cluster with which this Container is associated. 
*/ 
protected Cluster cluster = null; 


[RK 


* The human-readable name of this Container. 
ui 
protected String name = null; 
[PE 
* The parent Container to which this Container is a child. 
di 
protected Container parent = null; 
[PE 
* The parent class loader to be configured when we install a 
* Loader. 
*/ 
protected ClassLoader parentClassLoader = null; 
[RK 
* The Pipeline object with which this Container is 
* associated. 
"f 
protected Pipeline pipeline = new StandardPipeline(this); 
[E 
* The Realm with which this Container is associated. 
"f 
protected Realm realm - null; 
[RK 
* The resources DirContext object with which this Container 
* is associated. 
*/ 


protected DirContext resources = null; 
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代码 清单 4-1 中 那 多 余 而 又 有 误导 嫌疑 的 注释 吧 。 

你 有 没有 发 现 那 样 的 注释 是 如 何 误 导读 者 的 ? 在 this.closed 变 为 true 
的 时 候 ， 方 法 并 没有 返回 。 方 法 只 在 判断 到 this.closed 为 true 的 时 候 返 

， 否 则 ， 就 只 是 等 竺 遥遥 无 期 的 超时 ， 然 后 如 果 判 断 this.closed 还 是 

4Ftrue, IWA TAR, 

这 一 细微 的 误导 信息 ， 放 在 比 代 码 本 映 更 难 阅读 的 注释 里 面 ， 有 可 
能 导致 其 他 程序 员 快 活 地 调用 这 个 函数 ， 并 期 望 在 this.closed 变 为 true 时 
立即 返回 。 那 位 可 怜 的 程序 员 将 会 发 现 自己 陷于 调试 困境 之 中 ， 拼 命 想 
找 出 代码 执行 得 如 此 之 慢 的 原因 。 


4.4.4 循 规 式 注释 


所 谓 每 个 函数 都 要 有 Javadoc 或 每 个 变量 都 要 有 注释 的 规矩 全 然 是 
感 苇 可 笑 的 。 这 类 注释 徒然 让 代码 变 得 散乱 ， 满 口 胡 言 ， 令 人 迷惑 不 
解 。 

例如 ， 要 求 每 个 函数 都 要 有 Javadoc， 就 会 得 到 类 似 代 码 清单 4-3 那 
样 面目 可 民 的 代码 。 这 类 废话 只 会 搞 乱 代码 ， 有 可 能 误导 读者 。 

代码 清单 4-3 


[E 














* 


* @param title The title of the CD 
* @param author The author of the CD 
* @param tracks The number of tracks on the CD 


* @param durationInMinutes The duration of the CD in minutes 


*/ 
public void addCD(String title, String author, 
int tracks, int durationInMinutes) { 
CD cd = new CDO; 
cd.title = title; 
cd.author = author; 
cd.tracks = tracks; 
cd.duration = duration; 
cdList.add(cd); 


445 日 志 式 注释 


有 人 会 在 每 次 编辑 代码 时 ， 在 模块 开始 处 添加 一 条 注释 。 这 类 注释 
就 像 是 一 种 记录 每 次 修改 的 日 志 。 我 见 过 满 篇 尽 是 这 类 日 志 的 代码 模 
块 。 





* Changes (from 11-Oct-2001) 

* 11-Oct-2001 : Re-organised the class and moved it to new package 

* com.jrefinery.date (DG); 

* 05-Nov-2001 : Added a getDescription() method, and eliminated 
NotableDate 

$ class (DG); 

* 12-Nov-2001 : IBD requires setDescription() method, now that 
NotableDate 

* class is gone (DG) Changed 
getPreviousDayOfWeek(), 


* getFollowingDayOfWeek() and 
getNearestDayOfWeek() to correct 

* bugs (DG); 

* 05-Dec-2001 : Fixed bug in SpreadsheetDate class (DG); 

* 29-May-2002 : Moved the month constants into a separate interface 

* (MonthConstants) (DG); 

* 27-Aug-2002 : Fixed bug in addMonths() method, thanks to N??? 
levka Petr (DG); 

* 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

* 13-Mar-2003 : Implemented  Serializable (DG); 

* 29-May-2003 : Fixed bug in addMonths method (DG); 

*  04-Sep-2003 : Implemented Comparable. Updated the 
isInRange javadocs (DG); 

* 05-Jan-2005 : Fixed bug in addYears() method (1096282) (DG); 
人 那 时 ， 
我 们 还 没有 源 代码 控制 系统 可 用 。 如 今 ， 这 种 见长 的 记录 只 会 让 模块 变 

得 凌乱 不 堪 ， 应 当 全 部 删除 。 


4.4.6 废话 注释 


有 时 ， 你 会 看 到 纯 然 是 废话 的 注释 。 它 们 对 于 显然 之 事 唆 唆 不 休 ， 
ELBA. 

LI 

* Default constructor. 

*/ 

protected AnnualDateRule() { 

} 


对 吧 ? 再 看 看 这 个 : 

/** The day of the month. */ 

private int dayOfMonth; 

还 有 这 样 的 废话 模范 : 

Li 

* Returns the day of the month. 

* 

* @return the day of the month. 

*/ 

public int getDayOfMonth() { 

return dayOfMonth; 

} 

这 类 注释 废话 连篇 ， 我 们 都 学 会 了 视而不见 。 读 代码 时 ， 眼 光 不 会 
停留 在 它们 上 面 。 最 终 ， 当 代码 修改 之 后 ， 这 类 注释 就 变 作 了 方言 一 
ME, 

代码 清单 4-4 中 的 第 一 条 注释 貌似 还 行 [3]。 它 解释 了 catch 代 码 块 为 
何 被 忽略 。 不 过 第 二 条 注释 就 纯 是 废话 了 。 显 然 ， 该 程序 员 诅 丧 于 编号 
函数 中 那些 try/catch 代 码 块 。 

代码 清单 4-4 startSending 

private void startSending() 

{ 

try 
{ 
doSending(); 
} 
catch(SocketException e) 
{ 


// normal. someone stopped the request. 
} 
catch(Exception e) 
{ 
try 
{ 
response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 
} 
catch(Exception e1) 
{ 


// Give me a break! 


} 
与 其 纠缠 于 毫 无 价值 的 废话 注释 ， 程 序 员 应 该 意识 到 ， 他 的 挫败 感 
可 以 由 改进 代码 结构 而 消除 。 他 应 该 把 力气 花 在 将 最 末 一 个 try/catch 代 
码 块 拆 解 到 单独 的 函数 中 ， 如 代码 清单 4-5 所 示 。 
代码 清单 4-5 startSending ( 重 构 之 后 ) 
private void startSending() 
{ 
try 
{ 
doSending(); 
} 
catch(SocketException e) 
{ 








//hnormal. someone stopped the request. 
j 
catch(Exception e) 
{ 

addExceptionAndCloseResponse(e); 


} 
private void addExceptionAndCloseResponse(Exception e) 
{ 
try 
{ 
response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 
} 
catch(Exception e1) 
{ 
} 
} 
FEES BU Deco EROE RT. MERMA ERNE 
秀 、 更 快乐 的 程序 员 。 


4.4.7 可 怕 的 废话 


Javadoc 也 可 能 是 废话 。 下 列 Javadoc (来 自 某 知名 开源 库 ) 的 目的 
是 什么 ? CES: 无 。 它 们 只 是 源 目 某 种 提供 文档 的 不 当 愿 望 的 废话 注 
释 。 


/** The name. */ 


private String name; 

/** The version. */ 

private String version; 

/** The licenceName. */ 

private String licenceName; 

/** The version. */ 

private String info; 

FF ASE Se TERE, MERRI T TALE? 如 果 作 者 在 
写 〈 或 粘贴 ) 注释 时 都 没 花 心思 ， 怎 么 能 指望 读者 从 中 获 益 呢 ? 


9 JUD 
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看 看 以 下 代码 概要 : 

// does the module from the global list <mod> depend on the 

// subsystem we are part of? 

if 
(smodule.getDependSubsystems().contains(subSysMod.getSubSystem())) 

可 以 改 成 以 下 没有 注释 的 版 本 : 

ArrayList moduleDependees = smodule.getDependSubsystems(); 

String ourSubSystem = subSysMod.getSubSystem(); 

if (moduleDependees.contains(ourSubSystem)) 

代码 原作 者 可 能 (不 太 像 是 先 写 注释 再 编写 代码 。 不 过 ， 作 者 应 
该 重 构 代码 ， 如 我 所 做 的 那样 ， 从 而 删 挥 注释 。 


4.4.9 位 置 标记 


有 了 时， 程序 员 襄 欢 在 源 代码 中 标记 某 个 特别 位 置 。 例 如 ， 最 近 我 在 
程序 中 看 到 这 样 一 行 : 





// Actions MA/ 

把 特定 函数 做 放 在 这 种 标记 栏 下 面 ， 多 数 时 候 实 属 无 理 。 鸡 零 狗 
碎 ， 理 当 删 除 一 特别 是 尾部 那 一 长 串 无 用 的 斜 杠 ，。 

这 么 说 吧 。 如 果 标 记 栏 不 多 ， 就 会 显而易见 。 所 以 ， 尽 量 少 用 标记 
栏 ， 只 在 特别 有 价值 的 时 候 用 。 如 果 洲 用 标记 栏 ， 就 会 沉没 在 背景 噪音 
中 ， 被 忽略 掉 。 














4.4.10 15 注释 


有 了 时， 程序 员 会 在 括号 后 面 放置 特殊 的 注释 ， 如 代码 清单 4-6 所 
示 。 尺 管 这 对 于 含有 深度 授 套 结构 的 长 函数 可 能 有 意义 ， 但 只 会 给 我 们 
更 愿意 编写 的 短小 、 封 装 的 函数 带 来 混乱 。 如 果 你 发 现 自己 想 标记 右 括 
号 ， 其 实 应 该 做 的 是 缩短 函数 。 

代码 清单 4-6 we.java 


public class wc { 














public static void main(String[] args) { 
BufferedReader in = new BufferedReader(new 
InputStreamReader(System.in)); 
String line; 
int lineCount = 0; 
int charCount = 0; 
int wordCount = 0; 
try { 
while ((line = in.readLine()) != null) { 
lineCount++; 
charCount += line.length(); 
String words[] = line.split("\\W"); 


wordCount += words.length; 
) //while 
System.out.println("wordCount = " + wordCount); 
System.out.println("lineCount = " + lineCount); 
System.out.println("charCount = " + charCount); 
) // try 
catch (IOException e) 1 


System.err.println("Error:" + e.getMessage()); 


} //catch 
} //main 
} 
4.4.11 JA 属 与 #4 
/* Added by Rick */ 











源 代码 控制 系统 非常 善于 记 住 是 谁 在 何 时 添加 了 什么 。 没 必要 用 那 
些小 小 的 签名 搞 脏 代码 。 你 也 许 会 认为 ， 这 种 注释 大 概 有 助 于 他 人 了 解 
应 该 和 谁 讨 论 这 段 代码 。 不 过 ， 事 实 却 是 注释 在 那儿 放 了 一 年 义 一 年 ， 
越 来 越 不 准确 ， 越 来 越 和 原作 者 没关系 。 

重申 一 下 ， 源 代码 控制 系统 是 这 类 信息 最 好 的 归属 地 。 











直接 把 代码 注释 掉 是 讨厌 的 做 法 。 别 这 么 干 ! 
InputStreamResponse response = new InputStreamResponse(); 
response.setBody(formatter.getResultStream(), 
formatter.getByteCount()); 


// InputStream resultsStream = formatter.getResultStream(); 


// StreamReader reader = new StreamReader(resultsStream); 

// response.setContent(reader.read(formatter.getByteC ount())); 

其 他 人 不 敢 删 除 注释 掉 的 代码 。 他 们 会 想 ， 代 码 依然 放 在 那儿 ， 一 
定 有 其 原因 ， 而 且 这 段 代码 很 重要 ， 不 能 删除 。 注 释 抒 的 代码 堆积 在 一 
id, MARIAE — AR e 

看 看 以 下 来 自 Apache 公 共 库 的 代码 : 

this.bytePos = writeBytes(pngIdBytes, 0); 

//hdrPos = bytePos; 


writeHeader(); 





writeResolution(); 

//dataPos = bytePos; 

if (writeImageData()) { 

writeEnd(); 
this.pngBytes = resizeByteArray(this.pngBytes, this.maxPos); 
} 
else{ 
this.pngBytes=null; 

} 

return this.pngBytes; 

这 两 行 代码 为 什么 要 注释 掉 ? 它们 重要 吗 ? 它们 搁 在 那儿 ， 是 为 了 
给 未 来 的 修改 做 提示 吗 ? 或 者 ， 只 是 菜 人 在 多 年 以 前 注释 控 、 懒 得 清理 
的 过 时 玩意 ? 

20 世 纪 60 年 代 ， 曾 经 有 那么 一 段 时 间 ， 注 释 掉 的 代码 可 能 有 用 。 但 
我 们 已 经 拥有 优良 的 源 代码 控制 系统 如 此 之 入 ， 这 些 系统 可 以 为 我 们 记 
住 不 要 的 代码 。 我 们 无 需 再 用 注释 来 标记 ， 删 掉 即 可 ， 它 们 丢 不 了 。 我 
担保 。 


4.4.13 HTML}E XE 


源 代 码 注释 中 的 HIML 标 记 是 一 种 厌 物 ， 如 你 在 下 面 代码 中 所 见 。 
编辑 器 /IDE 中 的 代码 本 来 易于 阅读 ， 却 因为 HTML 注释 的 存在 而 变 得 难 
以 众 读 。 如 果 注 释 将 由 某 种 工具 (例如 Javadoc) 抽取 出 来 ， 呈 现 到 网 
页 ， 那 么 该 是 工具 而 非 程序 员 来 负责 给 注释 加 上 合适 的 HTML 标签。 


[** 








* Task to run fit tests. 

* This task runs fitnesse tests and publishes the results. 

* <p/> 

* <pre> 

* Usage: 

* &lt;taskdef name-&quot;execute-fitnesse-tests&quot; 

* 
classname=&quot;fitnesse.ant.ExecuteFitnesseTestsTask&quot; 

ii classpathref=&quot;classpath&quot; /&gt; 

* OR 

* &lt;taskdef classpathref=&quot;classpath&quot; 

sù resource=&quot;tasks.properties&quot; /&gt; 

* <p/> 


* &lt;execute-fitnesse-tests 


iù suitepage-&quot;FitNesse.SuiteA cceptanceTests&quot; 
€ fitnesseport=&quot;8082&quot; 

ii resultsdir-&quot;$ (results.dir) &quot; 

e resultshtmlpage-&quot;fit-results.html&quot; 

sù classpathref=&quot;classpath&quot; /&gt; 


* </pre> 


*/ 


- I 
willy 


4.4.14 I 


假如 你 一 定 要 写 注释 ， 请 确保 它 描述 了 离 它 最 近 的 代码 。 别 在 本 地 
sii 注释 为 例 ， 
除了 那 可 怕 的 元 余 之 外 ， EE TE A Ae EE 不 过 该 函数 
完全 没 控 制 到 那个 所 谓 默认 值 。 这 个 注释 并 未 描述 该 函数 ， 而 是 在 描述 
系统 中 远 在 他 方 的 其 他 函数 。 当 然 ， 也 无 法 担保 在 包含 那个 默认 值 的 代 


人 码 修改 之 后 ， 
这 里 的 注释 也 会 跟着 修改 。 
/ 米 米 


* Port on which fitnesse would run. Defaults to <b>8082</b>.* 
* @param fitnessePort 
"y 

public void setFitnessePort(int fitnessePort) 

| 


this.fitnessePort = fitnessePort; 





别 在 注释 中 添加 有 趣 的 历史 性 话题 或 者 无 天 的 细 市 插 述 。 下 列 注释 
来 自作 个 用 来 测试 base64 编 解码 函数 的 模块 。 除 了 RFC 文 档 编号 之 外 ， 
注释 中 的 其 他 细节 信息 对 于 读者 完全 没有 必要 
pr 
RFC 2045 - Multipurpose Internet Mail Extensions (MIME) 


Part One: Format of Internet Message Bodies 





section 6.8. Base64 Content-Transfer-Encoding 

The encoding process represents 24-bit groups of input bits as output 
strings of 4 encoded characters. Proceeding from left to right, a 
24-bit input group is formed by concatenating 3 8-bit input groups. 
These 24 bits are then treated as 4 concatenated 6-bit groups, each 
of which is translated into a single digit in the base64 alphabet. 
When encoding a bit stream via the base64 encoding, the bit stream 
must be presumed to be ordered with the most-significant-bit first. 
That is, the first bit in the stream will be the high-order bit in 

the first 8-bit byte, and the eighth bit will be the low-order bit in 
the first 8-bit byte, and so on. 

g 


y 
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写 注释 ， 人 至 少 让 读者 能 看 着 注释 和 代码 ， 并 且 理 解 注释 所 谈 何 物 。 
以 来 和 目 Apache 公 共 库 的 这 段 注 释 为 例 : 
pe 
* start with an array that is big enough to hold all the pixels 
* (plus filter bytes), and an extra 200 bytes for header info 
*/ 
this.pngBytes = new byte[((this.width + 1) * this.height * 3) + 200]; 
过 滤器 字 市 是 什么 ? 与 那个 +1 有 关系 吗 ? 或 与 *3 AR? 还 是 与 两 
BEAR? 为 什么 用 200? 注释 的 作用 是 解释 未 能 自行 解释 的 代码 。 如 
果 注 释 本 映 还 需要 解释 ， 就 太 遗 憾 了 。 


4.4.17 函数 头 


短 函 数 不 需 要 太 多 描述 。 为 只 做 一 件 事 的 短 函 数 选 个 好 名 字 ， 通 常 
要 比 写 函 数 头 注释 要 好 。 


4.4.18 韭 公 共 代 码 中 的 Javadoc 


虽然 Javadoc 对 于 公共 API 非 常 有 用 ， 但 对 于 不 打算 作 公 共用 途 的 代 
码 就 令 人 厌恶 了 。 为 系统 中 的 类 和 函数 生成 Javadoc 页 并 非 总 有 用 ， 而 
Javadoc 注 释 额 外 的 形式 要 求 几乎 等 同 于 八股 文章 。 


4.4.19 范例 











我 曾 为 首 个 XP ”Immersion[4] 课 程 编写 了 代码 清单 4-7 列 出 的 模块 。 
这 个 模块 几乎 是 糟 粹 的 代码 和 坏 注释 风格 的 典范 。 后 来 Kent ”Beck 当 着 
几 十 位 满腔 热情 的 学 生 的 面 重 构 了 这 些 代 码 ， 将 其 变 得 令 人 恰 屏 。 后 
ok, FRE Agile Software Development, Principles, Patterns, and 
Practices (中 译 版 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》)〉 和 Software 
Development〈 软 件 开发 ) 杂志 的 “技艺 ”专栏 的 第 一 篇 文章 中 引用 了 这 
^T. 
这 个 模块 最 迷人 的 地 方 是 ， 有 那么 一 阵 ， 我 们 中 的 许多 人 都 认为 
它 “ 文 档 做 得 很 好 ”。 如 今 ， 我 们 认为 它 是 一 小 团 乱 厂 。 看 看 你 能 发 现 多 
少 个 不 同 的 注释 问题 吧 。 
代码 清单 4-7 GeneratePrimes.java 
per 
* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 


* <p> 


* Eratosthenes of Cyrene, b. c. 276 BC, Cyrene, Libya -- 
* d. c. 194, Alexandria. The first man to calculate the 
* circumference of the Earth. Also known for working on 
* calendars with leap years and ran the library at Alexandria. 
* <p> 
* The algorithm is quite simple. Given an array of integers 
* starting at 2. Cross out all multiples of 2. Find the next 
* uncrossed integer, and cross out all of its multiples. 
* Repeat untilyou have passed the square root of the maximum 
* value. 
* 
* @author Alphonse 
* @version 13 Feb 2002 atp 
Ù 
import java.util.*; 
public class GeneratePrimes 
{ 
[ex 
* @param maxValue is the generation limit. 
SI 
public static int[] generatePrimes(int maxValue) 
{ 
if (maxValue >= 2) // the only valid case 
{ 
// declarations 
int s = maxValue + 1; // size of array 


boolean[] f = new boolean[s]; 


int i; 
// initialize array to true. 
for (i = 0; i < s; i++) 
f[i] = true; 
// get rid of known non-primes 
f[0] = f[1] = false; 
// sieve 
int j; 
for (i = 2; i < Math.sqrt(s) + 1; i++) 
{ 
if (f[i]) // if i is uncrossed, cross its multiples. 
{ 
for (j = 2 * i; | <s;j +=i) 


f[j] = false; // multiple is not prime 


} 
// how many primes are there? 
int count = 0; 
for (i = 0; i < s; i++) 
{ 

if (f[i]) 

count++; // bump count. 

} 
int[] primes = new int[count]; 
// move the primes into the result 
for (i = 0, j = 0; i< s; i++) 


{ 


if (f[i]) // if prime 
primes[j++] = i; 
} 
return primes; // return the primes 
} 
else // maxValue < 2 


return new int[0]; // return null array if bad input. 


} 
在 代码 清单 4-8 中 ， 你 可 以 看 到 该 模块 重 构 后 的 版 本 。 注 意 ， 注 释 
的 使 用 被 明显 地 限制 了 。 在 整个 模块 中 只 有 两 个 注释 。 每 个 注释 都 足 具 
说 明 意义 。 
代码 清单 4-8 PrimeGenerator.java ( 重 构 后 ) 
fe 
* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 
* Given an array of integers starting at 2: 
* Find the first uncrossed integer, and cross out all its 
* multiples. Repeat until there are no more multiples 
* in the array. 
2 
public class PrimeGenerator 
{ 
private static boolean[] crossedOut; 
private static int[] result; 
public static int[] generatePrimes(int maxValue) 


{ 


if (maxValue < 2) 
return new int[0]; 

else 

{ 
uncrossIntegersUpTo(maxValue); 
crossOutMultiples(); 
putUncrossedIntegersIntoResult(); 


return result; 


} 
private static void uncrossIntegersUpTo(int maxValue) 
{ 
crossedOut = new boolean[maxValue + 1]; 
for (int i = 2; i < crossedOut.length; i++) 
crossedOut[i] = false; 
} 
private static void crossOutMultiples() 
{ 
int limit = determinelterationLimit(); 
for (int i = 2; i <= limit; i++) 
if (notCrossed(i)) 
crossOutMultiplesOf(i); 
} 
private static int determinelterationLimit() 
{ 
// Every multiple in the array has a prime factor that 


// is less than or equal to the root of the array size, 


// so we don't have to cross out multiples of numbers 
// \arger than that root. 
double iterationLimit = Math.sqrt(crossedOut.length); 
return (int) iterationLimit; 
} 
private static void crossOutMultiplesOf(int i) 
{ 
for (int multiple = 2*i; 
multiple < crossedOut.length; 
multiple += i) 


crossedOut[multiple] = true; 


} 
private static boolean notCrossed(int i) 
{ 
return crossedOut[i] == false; 
} 


private static void putUncrossedIntegersIntoResult() 
{ 
result = new int[numberOfUncrossedIntegers()]; 
for (int j = 0, i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 
result[j++] = i; 
} 
private static int numberOfUncrossedIntegers() 
{ 
int count = 0; 


for (int i = 2; i < crossedOut.length; i++) 


if (notCrossed(i)) 
count++; 
return count; 
} 

} 

很 容易 说 明 ， 第 一 个 注释 完全 是 多 余 的 ， 因 为 它 读 起 来 非常 像 是 
generatePrimes ”函数 目 身 。 不 过 ， 我 认为 这 段 注 释 还 是 省 了 读者 去 读 有 具 
体 算法 的 精力 ， 所 以 我 倾 问 于 留 下 它 。 

第 二 个 注释 显然 很 有 必要 。 它 解释 了 平方 根 作为 循环 限制 的 理由 。 
我 找 不 到 能 说 明白 这 个 问题 的 简单 变量 名 或 者 其 他 编程 结构 。 男 外 ， 对 
平方 根 的 使 用 可 能 也 有 点 武断 。 通 过 限制 平方 根 循环 ， 我 是 否 真 节省 了 
许多 时 间 ? 平方 根 计算 所 花 的 时 间 会 不 会 比 省 下 的 时 间 还 要 多 ?这 些 都 
值得 考虑 。 使 用 平方 根 作为 循环 限制 ， 满 足 了 我 这 种 旧式 C 语 言 和 汇编 
语言 黑客 ， 不 过 我 可 不 敢 说 抵 得 上 其 他 人 为 理解 它 而 花 的 时 间 和 精力 。 
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4.5 


[KP78]: Kernighan and Plaugher, The Elements of Programming Style, 
2d. ed., McGraw- Hill, 1978. 





DUE: [KP78], p. 144. 
[21. 译 注 : 意 为 “运行 时 间 过 长 ”。 


BILE: IDE 对 注释 中 拼写 检查 的 支持 对 我 们 这 些 看 大 量 代码 的 人 实在 
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知 到 的 对 细节 的 关注 而 震惊 。 我 们 希望 他 们 高 高 扬 起 眉毛 ， 一 路 看 下 
去 。 我 们 硕 望 他 们 感受 到 那些 为 之 画作 的 专业 人 士 们 。 但 知 他 们 看 到 的 
只 是 一 堆 像 是 由 酒 醉 的 水 手写 出 的 鬼 男 待 ， 那 他 们 多 半 会 得 出 结论 ， 认 
为 项 目 其 他 任何 部 分 也 同样 对 细节 漠不关心 。 

你 应 该 保持 良好 的 代码 格式 。 你 应 该 选用 一 套 管理 代码 格式 的 简单 
规划， 然后 贯彻 这 些 规则 。 如 果 你 在 团队 中 工作 ， 则 团队 应 该 一 致 同意 
采用 一 套 简 单 的 格式 规则 ， 所 有 成 员 都 要 遵从 。 使 用 能 帮 你 应 用 这 些 格 
式 规则 的 自动 化 工具 会 很 有 帮助 。 








5.1 aie i 


先 明 确 一 下 ， 代 码 格式 很 重要 。 代 码 格式 不 可 忽略 ， 必 须 严肃 对 
待 。 代 码 格式 关乎 沟通 ， 而 沟通 是 专业 开发 者 的 头等 大 事 。 

或 许 你 认为 “让 代码 能 工作 ? 才 是 专业 开发 者 的 头等 大 事 。 然 而 ， 我 
希望 本 书 能 让 你 抛 挥 那 种 想法 。 你 今天 编写 的 功能 ， 极 有 可 能 在 下 一 版 
本 中 被 修改 ， 但 代码 的 可 读 性 却 会 对 以 后 可 能 发 生 的 修改 行为 产生 深远 
影响 。 原 始 代码 修改 之 后 很 信 ， 其 代码 风格 和 可 读 性 仍 会 影响 到 可 维护 
性 和 扩展 性 。 即 便 代码 已 不 复 存在 ， 你 的 风格 和 律 条 仍 存活 下 来 。 

那么 ， 哪 些 代 码 格式 相关 方面 能 帮 我 们 最 好 地 沟通 呢 ? 








5.2 垂直 格式 


从 垂直 尺寸 开始 吧 。 源 代码 文件 该 有 多 大 ? 在 Java 中 ， 文 件 尺 寸 与 
类 尺寸 极其 相关 。 讨 论 类 时 再 说 类 的 尺寸 。 现 在 先 考 虑 文件 尺寸 。 

多 数 Java 源 代码 文件 有 多 大 ?事实 说 明 ， 尺 寸 各 各 不 同 ， 长 度 殊 
异 ， 如 图 5-1 所 示 。 


10000.0 £ 





1000.0 上 




















每 个 文件 中 的 代码 行 数 





junit fitnesse testNG tam jdepend ant tomcat 


图 5-1 以 对 数 标 尺 显示 的 文件 长 度 分 布 ( 方 块 高 度 =sigma) 


图 5-1 中 涉及 7 个 不 同 项 目 : Junit, FitNesse. testNG, Time and 
Money, JDepend, Ant#lTomcat. ii F J HRH] A Zini H P 
最 小 和 最 大 的 文件 长 度 。 方 块 表示 在 平均 值 以 上 或 以 下 的 大 约 三 分 之 
文件 《一 个 标准 偏差 [1]〉 的 长 度 。 方 块 中 间 位 置 就 是 平均 数 。 所 以 
FitNesse ”项 目的 文件 平均 尺寸 是 65 行 ， 而 上 面 三 分 之 一 在 40 一 100 行 及 
100 行 以 上 之 间 。FitNesse 中 最 大 的 文件 大 约 400 行 ， 最 小 是 6 行 。 这 是 个 




















对 数 标 尺 ， 所 以 较 小 的 垂直 位 置 差 异 意 味 痢 文件 绝对 尺 二 的 较 大 差异 。 

Junit、FitNesse 和 Time and Money 由 相对 较 小 的 文件 组 成 。 没 有 一 
个 超过 500 行 ， 多 数 都 小 于 200 行 。Tomcat 和 Ant 则 有 些 文 件 达到 数 干 
行 ， 将 近 一 半 文 件 长 于 200 行 。 

对 我 们 来 襄 ， 这 意味 着 什么 ”意味 着 有 可 能 用 大 多 数 为 200 行 、 最 
长 500 行 的 单个 文件 构造 出 色 的 系统 〈FitNesse 总 长 约 50000 行 ) 。 尽 管 
这 并 非 不 可 违背 的 原则 ， 也 应 该 乐于 接受 。 短 文件 通常 比 长 文件 易于 理 
解 。 








想 想 看 写 得 很 好 的 报纸 文章 。 你 从 上 到 下 阅读 。 在 顶部 ， 你 期 望 有 
个 头条 ， 告 诉 你 故事 主题 ， 好 让 你 决定 是 人 否 要 读 下 去 。 第 一 段 是 整个 故 
事 的 大 纲 ， 给 出 粗 线条 概述 ， 但 隐藏 了 故事 细节 。 接 着 读 下 去 ， 细 市 渐 
次 增加 ， 直 至 你 了 解 所 有 的 日 期 、 名 字 、 引 语 、 说 法 及 其 他 细 市 。 

源 文 件 也 要 像 报 纸 文章 那样 。 名 称 应 当 简 单 且 一 目 了 然 。 名 称 本 喘 
应 该 足够 告诉 我 们 是 否 在 正确 的 模块 中 。 源 文件 最 顶部 应 该 给 出 高 层次 
概念 和 算法 。 细 市 应 该 往 下 渐次 展开 ， 直 至 找到 源 文 件 中 最 底层 的 函数 
和 细节 。 

报纸 由 许多 篇 文章 组 成 ， 多 数 短 小 精 悍 。 有 些 稍微 长 点 儿 。 很 少 有 
占 满 一 整 页 的 。 这 样 做 ， 报 纸 才 可 用 。 假 大 一 份 报纸 只 登载 一 篇 长 故 
事 ， 其 中 充斥 时 无 组 织 的 事实 、 日 期 、 名 字 等 ， 没 人 会 去 读 它 。 




















几乎 所 有 的 代码 都 是 从 上 往 下 读 ， 从 左 往 右 读 。 每 行 展现 一 个 表达 
式 或 一 个 子 句 ， 每 组 代码 行 展 示 一 条 完整 的 思路 。 这 些 思路 用 空白 行 区 
隔 开 来 。 





以 代码 清单 5-1 为 例 。 在 封包 声明 、 导 入 声明 和 每 个 函数 之 间 ， 都 
有 至 白 行 隔 开 。 这 条 极其 简单 的 规则 极 大 地 影响 到 代码 的 视觉 外 观 。 每 
个 空 日 行 都 是 一 条 线索 ， 标 识 出 新 的 独立 概念 。 往 下 读 代 码 时 ， 你 的 目 
光 总 会 停留 于 空 日 行 之 后 那 一 行 。 

代码 清单 5-1 BoldWidget.java 


package fitnesse.wikitext.widgets; 





import java.util.regex.*; 
public class BoldWidget extends ParentWidget { 
public static final String REGEXP = """+9""; 
private static final Pattern pattern = Pattern. SR +?) 
Pattern. MULTILINE + Pattern. DOTALL 
); 
public BoldWidget(ParentWidget parent, String text) throws 


nr 


Exception 1 

super(parent); 
Matcher match = pattern.matcher(text); 
match.find(); 
addChildWidgets(match.group(1)); 

} 

public String render() throws Exception { 
StringBuffer html = new StringBuffer("<b>"); 
html.append(childHtml()).append("</b>"); 
return html.toString(); 


} 
如 代码 清单 5-2 所 示 ， 抽 挥 这 些 空 日 行 ， 代 码 可 读 性 减弱 了 不 少 。 
代码 清单 5-2 BoldWidget.java 


package fitnesse.wikitext.widgets; 
import java.util.regex.*; 
public class BoldWidget extends ParentWidget { 
public static final String REGEXP = """+9""; 
private static final Pattern pattern = Pattern.compile(""(.+?) 
Pattern. MULTILINE + Pattern. DOTALL); 
public BoldWidget(ParentWidget parent, String text) throws 


nr 
3 


Exception { 

super(parent); 
Matcher match = pattern.matcher(text); 
match.find(); 
addChildWidgets(match.group(1)); } 

public String render() throws Exception { 
StringBuffer html = new StringBuffer("<b>"); 
html.append(childHtml()).append("</b>"); 
return html.toString(); 


} 

在 你 不 特意 注视 时 ， 后 条 就 更 严重 了 。 在 第 一 个 例子 中 ， 代 码 组 会 
PEER, TR HERUM. PBS EX All, FRAN Sa 
直方 向 上 区 隅 的 作用 。 





5.2.3 E EF EH EJ 











m 靠近 ee 
关系 。 所 以 ， 紧 密 相 关 的 代码 应 该 互相 靠近 。 注 意 代码 清单 5-3 中 的 注 
eg 





代码 清单 5-3 
public class ReporterConfig { 
Je 
* The class name of the reporter listener 
ui 
private String m_className; 
[ex 
* The properties of the reporter listener 
*y 
private List<Property> m properties = new ArrayList<Property>(); 
public void addProperty(Property property) 1 
m, properties.add(property); 
j 
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样 。 我 一 眼 就 能 看 到 ， 这 是 个 有 两 个 变量 和 一 个 方法 的 类 。 看 上 面 的 代 
码 时 ， 我 不 得 不 更 多 地 移动 头 部 和 眼球 ， 才 能 获得 相同 的 理解 度 。 
代码 清单 5-4 
public class ReporterConfig { 











private String m_className; 

private List<Property> m_properties = new ArrayList<Property>(); 

public void addProperty(Property property) { 
m_properties.add(property); 


~ 


5.2.4 HIE ER 
在 某 个 类 中 摸索 ， 从 一 个 函数 跳 到 另 一 个 函数 ， 上 下 求 
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片 在 哪里 。 

关系 密切 的 概念 应 该 互相 靠近 [G10]。 显 然 ， 这 条 规则 并 不 适用 于 
分 布 在 不 同文 件 中 的 概念 。 除 非 有 很 好 的 理由 ， 人 个 则 就 不 要 把 关系 密切 
的 概念 放 到 不 同 的 文件 中 。 实 际 上 ， 这 也 是 避免 使 用 protected 变 量 的 理 
AZ 

对 于 那些 关系 密切 、 放 置 于 同一 源 文件 中 的 概念 ， 它 们 之 间 的 区 隔 
应 该 成 为 对 相互 的 易 懂 度 有 多 重要 的 衡量 标准 。 应 避免 迫使 读者 在 源 文 
件 和 类 中 跳 来 跳 去 。 

变量 声明 。 变 量 声明 应 尽 可 能 靠近 其 使 用 位 置 。 因 为 函数 很 得， 本 
地 变量 应 该 在 函数 的 顶部 出 现 ， 惑 像 Junit4.3.1 中 这 个 稍 长 的 函数 中 那 
样 。 


private static void readPreferences() { 




















InputStream is= null; 
try { 
is= new FileInputStream(getPreferencesFile()); 
setPreferences(new Properties(getPreferences())); 
getPreferences().load(is); 
} catch (IOException e) { 
try { 
if (is != null) 
is.close(); 
} catch (IOException e1) 1 
} 


} 
循环 中 的 控制 变量 应 该 总 是 在 循环 语句 中 声明 ， 如 下 列 来 自 同一 项 
目的 绝妙 小 函数 所 示 。 


public int countTestCases() { 





int count= 0; 
for (Test each : tests) 
count += each.countTestCases(); 
return count; 
} 
偶尔 ， 在 较 长 的 函数 中 ， 变 量 也 可 能 在 菜 个 代码 块 项 部， 或 在 循环 
之 前 声明 。 你 可 以 在 以 下 摘自 TestNG 中 一 个 长 函数 的 代码 请 段 中 找到 类 
似 的 变量 。 





for (XmlTest test : m_suite.getTests()) { 

TestRunner tr = m_runnerFactory.newTestRunner(this, test); 

tr.addListener(m_textReporter); 

m testRunners.add(tr); 

invoker = tr.getInvoker(); 

for (ITestNGMethod m : tr.getBeforeSuiteMethods()) 1 
beforeSuiteMethods.put(m.getMethod(), m); 

j 

for (ITestNGMethod m : tr.getAfterSuiteMethods()) { 
afterSuiteMethods.put(m.getMethod(), m); 


} 





实体 变量 应 该 在 类 的 顶部 声明 。 这 应 该 不 会 增加 变量 的 垂直 距离 ， 





因为 在 设计 民 好 的 类 中 ， 它 们 如 果 不 是 被 该 类 的 所 有 方法 也 是 被 大 多 数 
方法 所 用 。 

关于 实体 变量 应 该 放 在 哪里 ， 和 争论 不 断 。 在 C++ 中 ， 通 常会 采用 所 
in “By JIN” (scissors rule) ， 所 有 实体 变量 都 放 在 底部 。 而 在 Java 
中 ， 惯 例 是 放 在 类 的 顶部 。 没 理由 去 遵循 其 他 惯例 。 重 点 是 在 谁 都 知道 
的 地 方 声明 实体 变量 。 大 家 都 应 该 知道 在 哪儿 能 看 到 这 些 声明 。 

例如 JUnit 4.3.1 中 的 这 个 奇怪 情形 。 我 极力 删 减 了 这 个 类 ， 好 说 明 
问题 。 如 果 你 看 到 代码 清单 大 致 一 半 的 位 置 ， 会 看 到 在 那里 声明 了 两 个 
实体 变量 。 如 果 放 在 更 好 的 位 置 ， 它 们 就 会 更 明显 。 而 现在 ， 读 代码 者 
只 能 在 无 意 中 看 到 这 些 声明 (就 像 我 一 样 )。 


public class TestSuite implements Test { 














static public Test createTest(Class<? extends TestCase> theClass, 


String name) { 


} 
public static Constructor<? extends TestCase> 
getTestConstructor(Class<? extends TestCase> theClass) 


throws NoSuchMethodException { 


} 


public static Test warning(final String message) { 


} 
private static String exceptionToString(Throwable t) { 


} 


private String fName; 


private Vector<Test> fTests= new Vector<Test>(10); 
public TestSuite() { 
} 


public TestSuite(final Class<? extends TestCase> theClass) { 


} 


public TestSuite(Class<? extends TestCase> theClass, String name) { 


} 
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序 。 大 坚定 地 遵循 这 条 约定 ， 读 者 将 能 够 确信 函数 声明 总 会 在 其 调用 后 
很 快 出 现 。 以 源 自 FitNesse 的 代码 清单 5-5 为 例 。 注 意 顶 部 的 函数 是 如 何 
调用 其 下 的 函数 ， 而 这 些 被 调用 的 函数 又 是 如 何 调 用 更 下 面 的 函数 的 。 
这 样 束 能 轻易 找到 被 调用 的 函数 ， 极 大 地 增强 了 整个 模块 的 可 读 性 。 

代码 清单 5-5 WikiPageResponder.java 


public class WikiPageResponder implements SecureResponder { 








protected WikiPage page; 
protected PageData pageData; 
protected String pageTitle; 
protected Request request; 
protected PageCrawler crawler; 
public Response makeResponse(FitNesseContext context, Request 
request) 


throws Exception { 


String pageName = getPageNameOrDefault(request, "FrontPage"); 
loadPage(pageName, context); 
if (page == null) 
return notFoundResponse(context, request); 
else 


return makePageResponse(context); 


} 

private String getPageNameOrDefault(Request request, String 
defaultPageName) 

{ 


String pageName = request.getResource(); 
if (StringUtil.isBlank(pageName)) 
pageName = defaultPageName; 
return pageName; 
} 
protected void loadPage(String resource, FitNesseContext context) 
throws Exception { 
WikiPagePath path = PathParser.parse(resource); 
crawler = context.root.getPageCrawler(); 
crawler.setDeadEndStrategy(new VirtualEnabledPageCrawler()); 
page = crawler.getPage(context.root, path); 
if (page != null) 
pageData = page.getData(); 
} 
private Response notFoundResponse(FitNesseContext context, Request 
request) 


throws Exception { 


return new NotFoundResponder().makeResponse(context, request); 
} 
private SimpleResponse makePageResponse(FitNesseContext context) 
throws Exception { 
pageTitle = PathParser.render(crawler.getFullPath(page)); 
String html = makeHtml(context); 
SimpleResponse response = new SimpleResponse(); 
response.setMaxAge(0); 
response.setContent(html); 
return response; 


} 


说 句 题 外 话 ， 以 上 代码 厂 段 也 是 把 常量 保持 在 恰当 级 别 的 好 例子 
[G35]. FrontPage tm *& n] UIE EgetPageNameOrDefaultré Zip rp, (AAS PER 
会 把 一 个 从 人缘 知 的 常量 埋藏 到 位 于 不 太 合 适 的 底层 函数 中 。 更 好 的 做 
法 是 把 它 放 在 易于 找到 的 位 置 ， 然 后 再 传递 到 真实 使 用 的 位 置 。 
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的 距离 就 该 越 短 。 

如 上 所 述 ， 相 关 性 应 建立 在 直接 依赖 的 基础 上 ， 如 函数 间 调 用 ， 或 
函数 使 用 某 个 变量 。 但 也 有 其 他 相关 性 的 可 能 。 相 关 性 可 能 来 自 于 执行 
相似 操作 的 一 组 函数 。 请 看 以 下 来 和 目 Junit 4.3.1 的 代码 片段 : 








public class Assert { 

static public void assertTrue(String message, boolean condition) { 

if (condition) 
fail(message); 

} 

static public void assertTrue(boolean condition) { 
assertTrue(null, condition); 

} 

static public void assertFalse(String message, boolean condition) { 
assert True(message, ! condition); 

} 

static public void assertFalse(boolean condition) { 
assertFalse(null, condition); 


} 


这 些 函 数 有 着 极 强 的 概念 相关 性 ， 因 为 他 们 拥有 共同 的 命名 模式 ， 
执行 同一 基础 任务 的 不 同 变种 。 互 相 调用 是 第 二 位 的 。 即 便 没 有 互相 调 
用 ， 也 应 该 放 在 一 起 。 


5.2.5 He EL JIH 
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中 。 代 码 清单 5-5 就 是 如 此 组 织 的 。 或 许 ， 更 好 的 例子 是 代码 清单 15-5， 
及 代码 清单 3-7。 


5.3 7 [n] kg 


一 行 代码 应 该 有 多 宽 ? 要 回答 这 个 问题 ， 来 看 看 典型 的 程序 中 代码 
行 的 宽度 。 我 们 再 一 次 检验 7 个 不 同 项 目 。 图 5-2 展 示 了 这 7 个 项 目的 代 
码 行 宽度 分 布 情况 。 其 中 展现 的 规律 性 令 人 印象 深刻 ，45 ”个 字符 左右 
的 宽度 分 布 尤为 如 此 。 其 实 ，20 一 60 的 每 个 尺寸 ， 都 代表 全 部 代码 行 数 
的 19%6。 也 就 是 总 共 40%1! 或 许 其 余 30% 的 代码 行 短 于 10 个 字符 。 记 住 ， 
这 是 个 对 数 标 尺 ， 所 以 图 中 长 于 80 个 字符 部 分 的 线性 下 降 在 实际 情况 中 
会 极其 可 观 。 程 序 员 们 显然 更 喜爱 短 代 码 行 。 
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代码 行 长 度 
图 5-2 Java 程 序 代码 行 长 度 分 布 

这 说 明 ， 应 该 尽力 保持 代码 行 短小 。 和 死守 80 个 字符 的 上 限 有 点 僵 
而 且 我 也 并 不 反对 代码 行 长 度 达到 100 个 字符 或 120 个 字符 。 再 多 的 
Kin we RBA I o 
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而 年 轻 程序 员 又 能 将 显示 字符 缩小 到 如 此 程度 ， 屏 幕 上 甚至 能 容纳 
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200 个 字符 的 宽度 。 别 那么 做 。 我 个 人 的 上 限 是 120 个 字符 。 





我 们 使 用 空格 字符 将 彼此 紧密 相关 的 事物 连接 到 一 起 ， 也 用 空格 字 


符 把 相关 性 较 弱 的 事物 分 隅 开 。 请 看 以 下 函数 : 


private void measureLine(String line) { 
lineCount++; 


int lineSize = line.length(); 


totalChars += lineSize; 

lineWidthHistogram.addLine(lineSize, lineCount); 

recordWidestLine(lineSize); 

} 
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有 两 个 确定 而 重要 的 要 素 : 左边 和 右边 。 空 格 字 符 加 强 了 分 隔 效果 。 

男 一 方面 ， 我 不 在 函数 名 和 左 圆 括号 之 间 加 空格 。 这 是 因为 函数 与 
其 参数 密切 相关 ， 如 果 隔 开 ， 就 会 显得 互 无 和 关系。 我 把 函数 调用 括号 中 
的 参数 一 一 隔 开 ， 强 调 喜 号， 表示 参数 是 互相 分 离 的 。 

空格 字符 的 另 一 种 用 法 是 强调 其 前 面 的 运算 符 。 

public class Quadratic { 

public static double root1(double a, double b, double c) { 














double determinant = determinant(a, b, c); 
return (-b + Math.sqrt(determinant)) / (2*a); 
} 
public static double root2(int a, int b, int c) { 
double determinant = determinant(a, b, c); 
return (-b - Math.sqrt(determinant)) / (2*a); 
} 
private static double determinant(double a, double b, double c) { 


return b*b - 4*a*c; 


} 

看 看 这 些 等 式 读 起 来 多 和 舒服。 乘法 因子 之 间 没 加 空格 ， 因 为 它们 具 
有 较 局 优先 级 。 加 减法 运算 项 之 间 用 空格 阳 开 ， 因 为 加 法 和 减法 优先 级 
较 低 。 

不 笠 的 是 ， 多 数 代 码 格式 化 工具 都 会 漠视 运算 符 优 移 级 ， 从 头 到 尾 





采用 同样 的 空格 方式 。 在 重新 格式 化 代码 后 ， 以 上 这 些微 妙 的 空格 用 法 
BUB AST. 


dd a 


当 我 还 是 个 汇编 语言 程序 员 时 [3]， 使 用 水 平 对 齐 来 强调 茶 些 程序 结 
构 。 开 始 用 C、C++ 编 码 ， 最 终 转 癌 Java 后 ， 我 继续 尽力 对 齐 一 组 声明 
中 的 变量 名 ， 或 一 组 赋值 语句 中 的 右 值 。 我 的 代码 看 起 来 大 概 是 这 样 : 

public class FitNesseExpediter implements ResponseSender 


{ 








private Socket socket; 
private InputStream input; 
private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 
private long requestParsing Deadline; 
private boolean hasError; 
public FitNesseExpediter(Socket S, 
FitNesseContext context) throws 
Exception 
{ 
this.context = context; 
socket = S; 


input = s.getInputStream(); 


output = s.getOutputStream(); 
requestParsingTimeLimit = 10000; 
} 


我 发 现 这 种 对 齐 方式 没什么 用 。 对 齐 ， 像 是 在 强调 不 重要 的 东西 ， 
把 我 的 目光 从 真正 的 意义 上 拉 开 。 例 如 ， 在 上 面 的 声明 列表 中 ， 你 会 从 
上 到 下 阅读 变量 名 ， 而 忽视 了 它们 的 类 型 。 同 样 ， 在 赋值 语句 代码 清单 
中 ， 你 也 会 从 上 到 下 阅读 右 值 ， 而 对 赋值 运算 和 从 视而不见 。 更 抹 烦 的 
是 ， 代 码 自动 格式 化 工具 通常 会 把 这 类 对 齐 消除 挥 。 

所 以 ， 我 最 终 放弃 了 这 种 做 法 。 如 今 ， 我 更 豆 欢 用 不 对 齐 的 声明 和 


赋值 ， 
处 理 ， 





如 下 所 示 ， 因 为 它们 指出 了 重点 。 如 果 有 较 长 的 列表 需要 做 对 齐 
那 问题 就 是 在 列表 的 长 度 上 而 不 是 对 齐 上 。 下 例 


FitNesseExpediter 类 中 声明 列表 的 长 度 说 明 该 类 应 该 被 拆 分 了。 


public class FitNesseExpediter implements ResponseSender 


{ 


private Socket socket; 

private InputStream input; 

private OutputStream output; 

private Request request; 

private Response response; 

private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 

private long requestParsingDeadline; 
private boolean hasError; 


public FitNesseExpediter(Socket s, FitNesseContext context) throws 


Exception 


{ 


this.context = context; 

socket = s; 

input = s.getInputStream(); 

output = s.getOutputStream(); 
requestParsing TimeLimit = 10000; 


5.3.3 4g it 


源 文件 是 一 种 继承 结构 ， 而 不 是 一 种 大 纲 结构 。 其 中 的 信息 涉及 整 
个 文件 、 文 件 中 每 个 类 、 类 中 的 方法 、 方 法 中 的 代码 块 ， 也 涉及 代码 块 
中 的 代码 块 。 这 种 继承 结构 中 的 每 一 层级 都 圈 出 一 个 范围 ， 名 称 可 以 在 
其 中 声明 ， 而 声明 和 执行 语句 也 可 以 在 其 中 解释 。 

要 让 这 种 范围 式 继承 结构 可 见 ， 我 们 依 源 代码 行 在 继承 结构 中 的 位 
置 对 源 代码 行 做 缩 进 处 理 。 在 文件 项 层 的 语句 ， 例 如 大 多 数 的 类 声明 ， 
根本 不 缩 进 。 类 中 的 方法 相对 该 类 缩 进 一 个 层级 。 方 法 的 实现 相对 方法 
声明 缩 进 一 个 层级 。 代 码 块 的 实现 相对 于 其 容 圳 代码 块 缩 进 一 个 层级 ， 
以 此 类 推 。 

程序 员 相 当 依 赖 这 种 缩 进 模式 。 他 们 从 代码 行 左 边 碍 看 目 己 在 什么 
范围 中 工作 。 这 让 他 们 能 快速 跳 过 与 当前 关注 的 情形 无 关 的 范围 ， 例 如 
并 或 while 语 句 的 实现 之 类 。 他 们 的 眼光 扫 过 左边 ， 查 找 新 的 方法 声明 、 
新 变量 ， 甚 至 新 类 。 没 有 缩 进 的 话 ， 程 序 就 会 变 得 无 法 阅读 。 

试看 以 下 在 语法 和 语义 上 等 价 的 两 个 程序 : 


public class FitNesseServer implements SocketServer {private 




















FitNesseContext 


context; public FitNesseServer(FitNesseContext context) { this.context 


context; } public void serve(Socket s) { serve(s, 10000); } public void 
serve(Socket s, long requestTimeout) { try { FitNesseExpediter sender = 
new 
FitNesseExpediter(s, context); 
sender.setRequestParsingTimeLimit(requestTimeout); sender.start(); } 
catch(Exception e) 1 e.printStackTrace(); } } } 
public class FitNesseServer implements SocketServer { 
private FitNesseContext context; 
public FitNesseServer(FitNesseContext context) { 
this.context = context; 
} 
public void serve(Socket s) { 
serve(s, 10000); 
} 
public void serve(Socket s, long requestTimeout) { 
try { 
FitNesseExpediter sender = new FitNesseExpediter(s, context); 
sender.setRequestParsing TimeLimit(requestTimeout); 
sender.start(); 
} 
catch (Exception e) { 
e.printStackTrace(); 


~ 


你 能 很 快 地 洞悉 有 缩 进 的 那个 文件 的 结构 。 你 几乎 能 立即 束 辨 列 出 


那些 变量 、 构 造 器 、 存 取 器 和 方法 。 只 需要 几 秒 钟 就 能 了 解 这 是 一 个 套 
接 字 的 简单 前 器 ， 其 中 包括 了 超时 设 定 。 而 未 缩 进 的 版 本 则 不 经 过 一 乍 
折腾 就 无 法 明白 。 
XB RIA. AI, T : 住 想 要 在 短小 的 if 185). while 循环 
或 小 函数 中 违反 缩 进 规则 。 么 做 了 ， 我 多 数 时 候 还 是 会 回头 加 上 
缩 进 。 这 样 就 避免 了 出 现 以 下 这 oe Hel ZR ER 0 — 47 BT DG: 
public class CommentWidget extends TextWidget 
{ 
public static final String REGEXP = "A#[/\r\n]*(?:(?:\r\n)|\n|\r)?"; 
public CommentWidget(ParentWidget parent, String text) 
{super(parent, text);} 
public String render() throws Exception {return ""; } 
} 
我 更 喜欢 扩展 和 缩 进 范围 ， 就 像 这 样 : 
public class CommentWidget extends TextWidget { 
public static final String REGEXP = "A#[/\r\n]*(?:(?:\r\n)|\n|\r)?"; 
public CommentWidget(ParentWidget parent, String text) { 
super(parent, text); 
} 
public String render() throws Exception { 


Wi, 


return 


5.3.4 ^ Yi 


[att 


有 时 ，while 或 for 语 句 的 语句 体 为 空 ， 如 下 所 示 。 我 不 喜欢 这 种 结 


构 ， 尽 量 不 使 用 。 如 果 无 法 避免 ， 就 确保 空 范围 体 的 缩 进 ， 用 括号 包围 
起 来 。 我 无 法 告诉 你 ， 我 曾经 多 少 次 被 静 静 安 坐 在 与 while 循环 语句 同 
一 行 末 尾 的 分 写 所 欺骗 。 除 非 你 把 那个 分 写 放 到 男 一 行 再 加 以 缩 进 ， 否 
则 就 很 难看 到 它 。 

while (dis.read(buf, 0, readBufferSize) != -1) 


5.4 团队 规 见 


每 个 程序 员 都 有 目 己 喜欢 的 格式 规则 ， 但 如 果 在 一 个 团队 中 工作 ， 
就 是 团队 说 了 算 [4]。 

一 组 开发 者 应 当 认 同一 种 格式 风格 ， 每 个 成 员 都 应 该 采用 那 种 风 
格 。 我 们 想 要 让 软件 拥有 一 以 贯 之 的 风格 。 我 们 不 想 让 它 显得 是 由 一 大 


票 意见 相左 的 个 人 所 写成 。 


2002 年 启动 FitNesse 项 目 时 ， 我 和 开发 团队 一 起 制订 了 一 套 编码 风 
格 。 这 只 花 了 我 们 10 分 钟 时 间 。 我 们 决定 了 在 什么 地 方 放 置 括号 ， 缩 进 
几 个 字符 ， 如 何 命名 类 、 变 量 和 方法 ， 如 此 等 等 。 然 后 ， 我 们 把 这 些 规 
则 编写 进 IDE 的 代码 格式 功能 ， 接 着 就 一 直 治 用 。 这 些 规则 并 非 全 是 我 
喜爱 的 ; 但 它们 是 团队 决定 了 的 规则 。 作 为 团队 一 员 ， 在 为 FitNesse 项 











—— — 





目 编写 代码 时 ， 我 遭 循 这 些 规则 。 

记 住 ， 好 的 软件 系统 是 由 一 系列 读 起 来 不 错 的 代码 文件 组 成 的 。 它 
们 需要 拥有 一 致 和 顺畅 的 风格 。 该 者 要 能 确信 ， 他 们 在 一 个 源 文 件 中 看 
到 的 格式 风格 在 其 他 文件 中 也 是 同样 的 用 法 。 绝 对 不 要 用 各 种 不 同 的 风 
格 来 编写 源 代 码 ， 这 样 会 增加 其 复杂 上 度 。 





5.5 z IPA E ww 


我 个 人 使 用 的 规则 相当 简单 ， 如 代码 清单 5-6 所 示 。 可 以 把 这 段 代 
码 看 作 是 展示 如 何 把 代码 写成 最 好 的 编码 标准 文档 的 范例 。 
代码 清单 5-6 CodeAnalyzer.java 


public class CodeAnalyzer implements JavaFileAnalysis { 





private int lineCount; 
private int maxLineWidth; 
private int widestLineNumber; 
private LineWidthHistogram lineWidthHistogram; 
private int totalChars; 
public CodeAnalyzer() { 
lineWidthHistogram = new LineWidthHistogram(); 
} 
public static List<File> findJavaFiles(File parentDirectory) { 
List<File> files = new ArrayList<File>(); 
findJavaFiles(parentDirectory, files); 
return files; 
} 
private static void findJavaFiles(File parentDirectory, List<File> 
files) { 
for (File file : parentDirectory.listFiles()) 1 
if (file.getName().endsWith(".java")) 
files.add(file); 


else if (file.isDirectory()) 
findJavaFiles(file, files); 


} 
public void analyzeFile(File javaFile) throws Exception { 
BufferedReader br = new BufferedReader(new 
FileReader(javaFile)); 
String line; 
while ((line = br.readLine()) != null) 
measureLine(line); 
} 
private void measureLine(String line) { 
lineCount++; 
int lineSize = line. length(); 
totalChars += lineSize; 
lineWidthHistogram.addLine(lineSize, lineCount); 
recordWidestLine(lineSize); 
} 
private void recordWidestLine(int lineSize) { 
if (lineSize > maxLineWidth) { 
maxLineWidth = lineSize; 


widestLineNumber = lineCount; 


} 
public int getLineCount() { 


return lineCount; 


public int getMaxLineWidth() { 
return maxLineWidth; 
} 
public int getWidestLineNumber() { 
return widestLineNumber; 
} 
public LineWidthHistogram getLineWidthHistogram() { 
return lineWidthHistogram; 
} 
public double getMeanLineWidth() { 
return (double) totalChars / lineCount; 
} 
public int getMedianLineWidth() { 
Integer[] sortedWidths = getSortedWidths(); 
int cumulativeLineCount = 0; 
for (int width : sortedWidths) { 
cumulativeLineCount += lineCountForWidth(width); 
if (cumulativeLineCount > lineCount / 2) 
return width; 
} 
throw new Error("Cannot get here"); 
} 
private int lineCountForWidth(int width) { 
return lineWidthHistogram.getLinesforWidth(width).size(); 
j 
private Integer[] getSortedWidths() 1 
Set<Integer> widths = lineWidthHistogram.getWidths(); 


Integer[] sortedWidths = (widths.toArray(new Integer[0])); 
Arrays.sort(sortedWidths); 
return sortedWidths; 





ULE: 方块 显示 平均 数 的 sigma/2 以 上 及 以 下 长 度 。 没 错 ， 我 知道 文 
PEER AA PAST RS 所 以 标准 偏差 也 并 非 那么 精确 。 不 过 在 此 并 不 寻 
求 精 确 ， 只 是 找 个 感觉 罢了 。 


[21. 原 注 : Pascal、C 和 C++ 等 ta Pee NIA, EXE F, BU 
该 在 被 调用 之 前 定义 ， 至 少 是 声明 。 

[3]. 原 注 : 开 什 么 玩笑 ! 到 现在 我 仍 是 个 汇编 语言 程序 员 。 把 男孩 从 铁 
旁边 赶 走 容易 ， 从 男孩 身边 把 铁 拿 走 可 难 ! 


[41. 译 注 : 团队 规则 ， 原 文 team rules。 单 词 rule 在 这 里 有 两 个 意思 ， 一 个 
是 名 词 “ 规 则 ”， 一 个 是 动词 “管辖 ?， 所 以 本 节 标 题 玩 了 个 文字 游戏 。 中 
文 不 易 翻 出 ， TUE e EIE. 

















将 变量 设置 为 和 有 (private) 有 一 个 理由 : 我 们 不 想 其 他 人 依赖 这 

些 变 量 。 我 们 还 想 在 心血 来 潮 时 能 自由 修改 其 类 型 或 实现 。 那 么 ， 为 什 

么 还 是 有 那么 多 程序 员 给 对 象 自动 添加 赋值 器 和 取 值 器 ， 将 私有 变量 公 
之 于 众 、 如 同 它 们 根本 就 是 公共 变量 一 般 呢 ? 





VIZ 


6.1 


TUB (CAS 6-1 Ss 6-22 RA BEER TS Ae RS 
儿 平 面 上 的 一 个 点 。 不 过 ， 其 中 之 一 曝露 了 其 实现 ， 而 另 一 个 则 完全 隐 
藏 了 其 实现 。 

代码 清单 6-1 具象 点 


public class Point { 








public double x; 
public double y; 
} 
代码 清单 6-2 抽象 点 
public interface Point { 
double getX(); 
double getY(); 
void setCartesian(double x, double y); 
double getR(); 
double getTheta(); 
void setPolar(double r, double theta); 
} 
代码 清单 6-2 的 漂亮 之 处 在 于 ， 你 不 知道 该 实现 会 是 在 矩形 坐标 系 
中 还 是 在 极 坐 标 系 中 。 可 能 两 个 都 不 是 ! 然而 ， 该 接口 还 是 明日 无 误 地 
呈现 了 一 种 数据 结构 。 
不 过 它 呈 现 的 还 不 止 是 一 个 数据 结构 。 那 些 方法 固定 了 一 套 存 取 策 
略 。 你 可 以 单独 读 取 某 个 坐标 ， 但 必须 通过 一 次 原子 操作 设 定 所 有 坐 














标 。 
而 代码 清单 6-1 则 非常 清楚 地 是 在 矩形 坐标 系 中 实现 ， 并 要 求 我 们 
单个 操作 那些 坐标 。 这 就 曝露 了 实现 。 实 际 上 ， 即 便 变 量 都 是 私有 ， 而 
且 我 们 也 通过 变量 取 值 器 和 赋值 器 使 用 变量 ， 其 实现 仍然 曝露 了 。 
隐藏 实现 并 非 只 是 在 变量 之 间 放 上 一 个 函数 层 那么 简单 。 隐 藏 实现 
关乎 抽象 ! 类 并 不 简单 地 用 取 值 器 和 赋值 器 将 其 变量 推 向 外 间 ， 而 是 曝 
露 抽象 接口 ， 以 便 用 户 无 需 了 解数 据 的 实现 就 能 操作 数据 本 体 。 
看 看 代码 清单 6-3 和 代码 清单 6-4。 前 者 使 用 具象 手段 与 机 动车 的 燃 
料 层 通 信 ， 而 后 者 则 采用 百分比 抽象 。 你 能 确定 前 者 里 面 都 是 些 变 量 存 
取 器 ， 而 却 无 法 得 知 后 者 中 的 数据 形态 。 
代码 清单 6-3 具象 机 动车 


public interface Vehicle { 























double getFuelTankCapacityInGallons(); 
double getGallonsOfGasoline(); 

} 

代码 清单 6-4 抽象 机 动车 

public interface Vehicle { 

double getPercentFuelRemaining(); 

} 

DI EPA RIS WR AE. RIMARRA, HUH 
形态 表述 数据 。 这 并 不 只 是 用 接口 和 /或 赋值 器 、 取 值 器 就 万 事 大 吉 。 
要 以 最 好 的 方式 呈现 某 个 对 象 包含 的 数据 ， 雷 要 做 严肃 的 思考 。 傻 乐 着 
乱 加 取 值 器 和 赋值 器 ， 是 最 坏 的 选择 。 














这 两 个 例子 展示 了 对 象 与 数据 结构 之 间 的 差异 。 对 象 把 数据 隐藏 于 
抽象 之 后 ， 曙 露 操 作 数 据 的 函数 。 数 据 结 构 明 露 其 数据 ， 没 有 提供 有 意 
义 的 函数 。 回 过 头 再 读 一 过 。 留 意 这 两 种 定义 的 本 质 。 和 它们 是 对 立 的 。 
这 种 差异 貌似 微小 ， 但 却 有 深远 的 含义 。 

例如 ， 代 码 清单 6-5 中 的 过 程式 代码 形状 范例 。Geometry 类 操作 三 
个 形状 类 。 形 状 类 都 是 简单 的 数据 结构 ， 没 有 任何 行为 。 所 有 行为 都 在 
Geometry 类 中 。 

代码 清单 6-5 过 程式 形状 代码 


public class Square { 








public Point topLeft; 
public double side; 

} 

public class Rectangle { 
public Point topLeft; 
public double height; 
public double width; 

} 

public class Circle { 
public Point center; 
public double radius; 

} 


public class Geometry { 


public final double PI = 3.141592653589793; 
public double area(Object shape) throws NoSuchShapeException 
{ 
if (shape instanceof Square) { 
Square s = (Square)shape; 
return s.side * s.side; 
} 
else if (shape instanceof Rectangle) { 
Rectangle r = (Rectangle)shape; 
return r.height * r.width; 
} 
else if (shape instanceof Circle) { 
Circle c = (Circle)shape; 
return PI * c.radius * c.radius; 
} 
throw new NoSuchShapeException(); 


} 

面向 对 象 程序 员 可 能 会 对 此 咯 之 以 异 ， 抱 怨 说 这 是 过 程式 代码 一 一 
他 们 大 概 是 对 的 ， 不 过 这 种 嘲笑 并 不 完全 正确 。 想 想 看 ， 如 果 给 
Geometry 类 添加 一 个 primeter( ”) 函 数 会 怎样 。 那 些 形状 类 根本 不 会 因此 
而 受 影响 ! 男 一 方面 ， 如 果 添加 一 个 新 形状 就 得 修改 Geometry 中 的 所 
有 函数 来 处 理 它 。 再 读 一 所 代码。 注意 ， 这 两 种 情形 也 是 直接 对 立 的 。 

现在 来 看 看 代码 清单 6-6 中 的 面向 对 象 方案 。 这 里 ，area( ) 方 法 是 多 
态 的 。 不 需要 有 Geometry 类 。 所 以 ， 如 果 添 加 一 个 新 形状 ， 现 有 的 函数 
一 个 也 不 会 受到 影响 ， 而 当 添 加 新 函数 时 所 有 的 形状 都 得 做 修改 [1]! 

代码 清单 6-6 多 态 式 形状 








public class Square implements Shape { 
private Point topLeft; 
private double side; 
public double area() { 


return side*side; 


} 
public class Rectangle implements Shape { 
private Point topLeft; 
private double height; 
private double width; 
public double area() { 
return height * width; 


} 
public class Circle implements Shape { 
private Point center; 
private double radius; 
public final double PI = 3.141592653589793; 
public double area() { 


return PI * radius * radius; 


} 

我 们 再 次 看 到 这 两 种 定义 的 本 质 ; 它们 是 截然 对 立 的 。 这 说 明了 对 
象 与 数据 结构 之 间 的 二 分 原理 : 

过 程式 代码 《使 用 数据 结构 的 代码 ) 便于 在 不 改动 既 有 数据 结构 的 
前 提 下 添加 新 函数 。 面 向 对 象 代码 便 于 在 不 改动 妹 有 函数 的 前 提 下 添加 














新 类 。 

反 过 来 讲 也 说 得 通 : 

过 程式 代码 难以 添加 新 数据 结构 ， 因 为 必须 修改 所 有 函数 。 面 癌 对 
象 代 码 难 以 添加 新 函数 ， 因 为 必须 修改 所 有 类 。 

所 以 ， 对 于 面向 对 象 较 难 的 事 ， 对 于 过 程式 代码 却 较 容易 ， 反 之 亦 
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的 时 候 。 这 时 ， 对 象 和 面向 对 象 就 比较 适合 。 另 一 方面 ， 也 会 有 想 要 添 
加 新 函数 而 不 是 数据 类 型 的 时 候 。 在 这 种 情况 下 ， 过 程式 代码 和 数据 结 
构 更 合适 。 

















XA BU RH (The Law of Demeter) [2] 认 为 ， 模 块 不 应 了 解 
它 所 操作 对 象 的 内 部 情形 。 如 上 节 所 见 ， 对 象 隐 藏 数据 ， 曝 露 操作 。 这 
意味 着 对 象 不 应 通过 存 取 器 曝露 其 内 部 结构 ， 因 为 这 样 更 像 是 曝露 而 非 
隐藏 其 内 部 结构 。 

更 准确 地 说 ， 得 墨 忒 耳 律 认为 ， 类 C 的 方法 { 只 应 该 调用 以 下 对 象 的 
方法 : 

C 

由 f 创 建 的 对 象 ; 

作为 参数 传递 给 f 的 对 象 ; 

由 C 的 实体 变量 持 有 的 对 象 。 

方法 不 应 调用 由 任何 函数 返回 的 对 象 的 方法 。 换 言 之 ， 只 跟 朋友 谈 
话 ， 不 与 陌生 人 谈话 。 

下 列 代 码 [] 违 反 了 得 墨 忒 耳 律 〈 除 了 违反 其 他 规则 之 外 ) ， 因 为 它 
调用 了 getOptions( ) 返 回 值 的 getScratchDir( ) 函 数 ， 又 调用 了 
getScratchDir( ) 人 返回 值 的 getAbsolutePath( ) 方 法 。 

final String outputDir = 

















ctxt.getOptions().getScratchDir().getAbsolutePath(); 


6.3.1 火车 失事 


这 类 代码 着 被 称 作 火 车 失事 ， 因 为 它 看 起 来 就 像 是 一 列 火车 。 这 关 
连 串 的 调用 通 币 被 认为 是 及 脏 的 风格 ， 应 该 避免 [G36]。 最 好 做 类 似 如 
下 的 切 分 : 


Options opts = ctxt.getOptions(); 

File scratchDir = opts.getScratchDir(); 

final String outputDir = scratchDir.getAbsolutePath(); 

LINE MER S ENEE? 当然 ， 模 块 知道 ctxt 对 象 包含 
有 多 个 选项 ， 每 个 选项 中 都 有 一 个 临时 目录 ， 而 每 个 临时 目录 都 有 一 个 
绝对 路 径 。 对 于 一 个 函数 ， 这 些 知识 真 够 丰富 的 。 调 用 函数 懂得 如 何在 
一 大 堆 不 同 对 象 间 浏览 。 
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露 ， 而 有 关 其 内 部 细节 的 知识 就 明显 违反 了 得 四 臣 耳 律 。 如 果 ctxt、 
Options 和 ScratchDir 只 是 数据 结构 ， 没 有 任何 行为 ， 则 它们 上 自然 会 曝露 
其 内 部 结构 ， 得 墨 趟 耳 律 也 就 不 适用 了 。 

属性 访问 器 函数 的 使 用 把 问题 搞 复 杂 了。 如 有 果 像 下 面 这 样 写 代 人 码 ， 
我 们 大 概 就 不 会 提 及 对 得 墨 忒 耳 律 的 违反 。 

final String outputDir = ctxt.options.scratchDir.absolutePath; 


如 打数 据 结 构 只 简单 地 拥有 公共 变量 ， 没 有 函数 ， 而 对 象 则 拥有 私 
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6.3.2 混杂 





这 种 混淆 有 时 会 不 泣 导 致 混合 结构 ， 一 半 是 对 象 ， 一 半 是 数据 结 
构 。 这 种 结构 拥有 执行 操作 的 函数 ， 也 有 公共 变量 或 公共 访问 器 及 改 值 
器 。 无 论 出 于 怎样 的 初衷 ， 公 共 访 问 髓 及 改 值 融 都 把 私有 变量 公开 化 ， 
诱导 外 部 函数 以 过 程式 程序 使 用 数据 结构 的 方式 使 用 这 些 变 量 [4]。 

此 类 混杂 增加 了 添加 新 函数 的 难度 ， 也 增加 了 添加 新 数据 结构 的 难 
度 ， 两 面 不 讨好 。 应 避免 创造 这 种 结构 。 它 们 的 出 现 ， 展 示 了 一 种 乱 七 
八 糟 的 设计 ， 其 作者 不 确定 一 一 或 者 更 糟 糙 ， 完 全 无 视 一 一 他 们 是 含 需 
要 函数 或 类 型 的 保护 。 











6.3.3 隐藏 结构 


假使 ctxt、Options 和 ScratchDir 是 拥有 真实 行为 的 对 象 又 怎样 呢 ? 由 
于 对 象 应 隐藏 其 内 部 结构 ， 我 们 就 不 该 能 够 看 到 内 部 结构 。 这 样 一 来 ， 
如 何 才能 取得 临时 目录 的 绝对 路 径 呢 ? 

ctxt.getAbsolutePathOfScratchDirectoryOption(); 

或 者 

ctx.getScratchDirectoryOption().getAbsolutePath() 

第 一 种 方案 可 能 导致 ctxt 对 象 中 方法 的 曝露 。 第 二 种 方案 是 在 假设 
getScratchDirectoryOption0 返 回 一 个 数据 结构 而 非 对 象 。 两 种 方案 感觉 
都 不 好 。 

如 果 ctxt 是 个 对 象 ， 就 应 该 要 求 它 做 点 什么 ， 不 该 要 求 它 给 出 内 部 
情形 。 那 我 们 为 何 还 要 得 到 临时 目录 的 绝对 路 径 呢 ?我 们 要 它 做 什么 ? 
来 看 看 同一 模块 (许多 行 之 后 ) 的 这 段 代 码 : 














String outFile = outputDir + "/" + className.replace(’.’, '/) + ".class"; 
FileOutputStream fout = new FileOutputStream(outFile); 
BufferedOutputStream bos = new BufferedOutputStream(fout); 

这 种 不 同 层级 细节 的 混杂 〈[G34][G36]) FARO. AA, FUT, 
文件 扩展 名 和 File 对 象 不 该 如 此 随便 地 混杂 到 一 起 。 不 过 ， 撤 开 这 些 毛 
痪 ， 我 们 发 现 ， 取 得 临时 目录 绝对 路 径 的 初 囊 是 为 了 创建 指定 名 称 的 临 
时 文件 。 

所 以 ， 直 接 让 ctxt 对 象 来 做 这 事 如 何 ? 


BufferedOutputStream bos - 





ctxt.createScratchFileStream(classFileName); 
这 下 看 起 来 像 是 个 对 象 做 的 事 了 ! ctxt 隐藏 了 其 内 部 结构 ， 防 止 当 
前 函数 因 浏览 它 不 该 知道 的 对 象 而 违反 得 墨 忒 耳 律 。 
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最 为 精练 的 数据 结构 ， 是 一 个 只 有 公共 变量 、 没 有 函数 的 类 。 这 种 
数据 结构 有 时 被 称 为 数据 传送 对 象 ， 或 DTO (Data Transfer Objects) 。 
DTO 是 非常 有 用 的 结构 ， 巨 其 是 在 与 数据 库 通 信 、 或 解析 套 接 字 传递 的 
消息 之 类 场景 中 。 在 应 用 程序 代码 里 一 系列 将 原始 数据 转换 为 数据 库 的 
翻译 过 程 中 ， 它 们 往往 是 排头 兵 。 

更 常见 的 是 如 代码 清单 6-7 所 示 的 “ 豆 ”(bean) 结构 。 豆 结构 拥有 由 
赋值 器 和 取 值 器 操作 的 私有 变量 。 对 豆 结构 的 半 封 装 会 让 某 些 OO 纯 化 
论 者 感觉 舒服 些 ， 不 过 通常 没有 其 他 好 处 。 

代码 清单 6-7 address.java 

public class Address { 








private String street; 
private String streetExtra; 
private String city; 
private String state; 
private String zip; 
public Address(String street, String streetExtra, 
String city, String state, String zip) { 
this.street = street; 
this.streetExtra = streetExtra; 
this.city = city; 
this.state = state; 


this.zip = zip; 


} 

public String getStreet() { 
retum street; 

} 

public String getStreetExtra() { 
return streetExtra; 

} 

public String getCity() { 
retum city; 

} 

public String getState() { 


return state; 


public String getZip() { 


return Zip; 


} 

Active Record 

Active Record 是 一 种 特殊 的 DTO 形 式 。 它 们 是 拥有 公共 (或 可 豆 式 
访问 的 ) 变量 的 数据 结构 ， 但 通常 也 会 拥有 类 似 save 和 find 这 样 的 可 浏 
览 方法 。Active Record 一 般 是 对 数据 库 表 或 其 他 数据 源 的 直接 翻译 。 

我 们 不 垃 经 常 发 现 开 发 者 往 这 类 数据 结构 中 塞 进 业 务 规则 方法 ， 把 
这 类 数据 结构 当成 对 象 来 用 。 这 是 不 智 的 行为 ， 因 为 它 导 致 了 数据 结构 
和 对 象 的 混杂 体 。 

当然 ， 解 决 方案 就 是 把 Active Record 当 做 数据 结构 ， 并 创建 包含 业 
务 规则 、 隐 藏 内 部 数据 (可 能 就 是 Active Record 的 实体 ) 的 独立 对 象 。 

















6.5 小 结 








对 象 上 曝露 行 为 ， 隐 藏 数据 。 便 于 添加 新 对 象 类 型 而 无 需 修改 既 有 行 
为 ， 同 时 也 难以 在 既 有 对 象 中 添加 新 行为 。 数 据 结构 曝露 数据 ， 没 有 明 
显 的 行为 。 便 于 癌 既 有 数据 结构 添加 新 行为 ， 同 时 也 难以 辣妹 有 函数 添 
加 新 数据 结构 。 

在 任何 系统 中 ， 我 们 有 时 会 希望 能 够 灵活 地 添加 新 数据 类 型 ， 所 以 
更 喜欢 在 这 部 分 使 用 对 象 。 另 外 一 些 时 候 ， 我 们 希望 能 灵活 地 添加 新 行 
为 ， 这 时 我 们 更 喜欢 使 用 数据 类 型 和 过 程 。 优 秀 的 软件 开发 者 不 带 成 见 
地 了 解 这 种 情形 ， 并 依据 手边 工作 的 性 质 选择 其 中 一 种 手段 。 
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[Refactoring]: Refactoring: Improving the Design of Existing Code, 
Martin Fowler et al., Addison-Wesley, 1999. 





DLE: 经 验 丰 富 的 面 癌 对 象 设 计 人 员 都 知道 一 些 方法 ， 例 如 ， 
VISITOR 模 式 ， 或 双向 分 派 。 但 这 些 技法 也 有 成 本 ， 而 且 通 常 返回 一 种 
过 程式 程序 的 结构 。 


[21. 原 注 : http://en.wikipedia.org/wiki/Law_of_Demeter. 
[3]. 原 注 : 来 自 Apache 框 架 中 某 处 。 
[41. 原 注 : 在 Refactoring: Improving the Design of Existing Code (中 译 版 


《 重 构 改善 既 有 代码 的 设计 《中 文 版 ) 》) 一 书 中 ， 有 时 把 这 种 情况 称 
作 特 性 依恋 (Feature Envy) 。 





Michael Feathers 





在 一 本 有 关 整 洁 代 码 的 书 中 ， 居 然 有 讨论 错误 处 理 的 音节， 看 起 来 
有 些 突 几 。 错 误 处 理 只 不 过 是 编程 时 必须 要 做 的 事 之 一 。 输 入 可 能 出 现 
异常 ， 设 备 可 能 失效 。 简 言 之 ， 可 能 会 出 错 ， 当 错误 发 生 时 ， 程 序 员 区 
有 责任 确保 代码 照常 工作 。 

然而 ， 应 该 弄 清楚 错误 处 理 与 整洁 代码 的 关系 。 许 多 程序 完全 由 错 
误 处 理 所 占 据 。 所 谓 占 据 ， 并 不 是 说 错误 处 理 就 是 全 部 。 我 的 意思 是 几 
乎 无 法 看 明白 代码 所 做 的 事 ， 因 为 到 处 都 是 凌乱 的 错误 处 理 代 码 。 错 误 
处 理 很 重要 ， 但 如 果 它 搞 乱 了 代码 逻辑 ， 束 是 错误 的 做 法 。 

在 本 章 中 ， 我 将 概要 列 出 编写 既 整 清 又 强 固 的 代码 一 一 雅致 地 处 理 











错误 代码 的 一 些 技巧 和 思路 。 








在 很 久 以 前 ， 许 多 语言 都 不 文 持 异常 。 这 些 语言 处 理 和 汇报 错误 的 
手段 都 有 限 。 你 要 么 设置 一 个 错误 标识 ， 要 么 返回 给 调用 者 检查 的 错误 
码 。 代 码 清单 7-1 中 的 代码 展示 了 这 些 手段 。 

代码 清单 7-1 DeviceController.java 


public class DeviceController { 





public void sendShutDown() { 
DeviceHandle handle = getHandle(DEV1); 
// Check the state of the device 
if (handle != DeviceHandle. INVALID) { 
// Save the device status to the record field 
retrieveDeviceRecord(handle); 
// If not suspended, shut down 
if (record. getStatus() != DEVICE SUSPENDED) { 
pauseDevice(handle); 
clearDeviceWorkQueue(handle); 
closeDevice(handle); 
} else { 
logger.log("Device suspended. Unable to shut down"); 
} 
} else { 
logger.log("Invalid handle for: " + DEV1.toString()); 


} 

这 类 手段 的 问题 在 于 ， 它 们 搞 乱 了 调用 者 代码 。 调 用 者 必须 在 调用 
之 后 即刻 检查 错误 。 不 幸 的 是 ， 这 个 步骤 很 容易 被 遗 瑟 。 所 以 ， 遇 到 错 
误 时 ， 最 好 抛 出 一 个 异常 。 调 用 代码 很 整洁 ， 其 逻辑 不 会 被 错误 处 理 搞 
乱 。 

代码 清单 7-2 展 示 了 在 方法 中 过 到 错误 时 抛 出 异常 的 情形 。 

代码 清单 7-2 DeviceController.java (采用 异常 处 理 ) 


public class DeviceController { 


public void sendShutDown() { 
try { 
tryToShutDown(); 
} catch (DeviceShutDownError e) 1 


logger.log(e); 


} 
private void tryToShutDown() throws DeviceShutDownError { 
DeviceHandle handle = getHandle(DEV 1); 
DeviceRecord record = retrieveDeviceRecord(handle); 
pauseDevice(handle); 
clearDeviceWorkQueue(handle); 
closeDevice(handle); 
} 
private DeviceHandle getHandle(DeviceID id) { 


throw new DeviceShutDowneError("Invalid handle for: " + 


id.toString()); 


) 

注意 这 段 代 码 整洁 了 很 多 。 这 不 仅 关 乎 美观 。 这 段 代码 更 好 ， 因 为 
之 前 纠结 的 两 个 元 素 设备 关闭 算法 和 错误 处 理 现在 被 隔离 了 。 你 可 以 得 
EEE OA, DIEE 
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异常 的 妙 处 之 一 是 ， 它 们 在 程序 中 定义 了 一 个 范围 。 执 行 try-catch- 
finally 语 句 中 try 部 分 的 代码 时 ， 你 是 在 表明 可 随时 取消 执行 ， 并 在 catch 
语句 中 接续 。 

EEMALE, try 代码 块 就 像 是 事务 。catch 代码 块 将 程序 维持 在 
一 种 持续 状态 ， 无 论 。 try 代 码 块 中 发 生 了 什么 均 如 此 。 所 以 ， 在 编写 可 
能 抛 出 异常 的 代码 时 ， 最 好 先 写 出 try-catch-finally 语 句 。 这 能 帮 你 定义 
代码 的 用 户 应 该 期 竺 什么， 无 论 try 代 码 块 中 执行 的 代码 出 什么 错 都 一 
样 。 

来 看 个 例子 。 我 们 要 编写 访问 某 个 文件 并 读 出 一 些 序列 化 对 象 的 代 
n3. 

先 写 一 个 单元 测试 ， 其 中 显示 当 文 件 不 存在 时 将 得 到 一 个 异常 : 

@Test(expected = StorageException.class) 








public void retrieveSectionShouldThrowOnInvalidFileName() { 
sectionStore.retrieveSection( "invalid - file"); 

} 

该 测试 驱动 我 们 创建 以 下 占 位 代码 : 

public List<RecordedGrip> retrieveSection(String sectionName) { 
// dummy return until we have a real implementation 
return new ArrayList<RecordedGrip>(); 

} 

测试 失败 了 ， 因 为 以 上 代码 并 未 抛 出 异常 。 下 一 步 ， 修 改 实现 代 

码 ， 尝 试 访问 非法 文件 。 该 操作 抛 出 一 个 异常 : 


public List<RecordedGrip> retrieveSection(String sectionName) { 
try { 
FileInputStream stream = new FileInputStream(sectionName) 
} catch (Exception e) { 
throw new StorageException("retrieval error", e); 
} 
return new ArrayList<RecordedGrip>(); 
} 
这 次 测试 通过 了 ， 因 为 我 们 捕获 了 异常 。 此 时 ， 我 们 可 以 重 构 了 。 
我 们 可 以 缩小 异常 类 型 的 范围 ， 使 之 人 符合 FileInputStream 构 造 器 真正 抛 
4995, BIFileNotFoundException: 


public List<RecordedGrip> retrieveSection(String sectionName) { 





try { 
FileInputStream stream = new FileInputStream(sectionName); 
stream.close(); 
} catch (FileNotFoundException e) { 
throw new StorageException("retrieval error", e); 
} 
return new ArrayList<RecordedGrip>(); 
} 
如 此 一 来 ， 我 们 束 用 try-catch 结 构 定 义 了 一 个 范围 ， 可 以 继续 用 测 
试 驱动 (TDD) 方法 构建 剩余 的 代码 逻辑 。 这 些 代码 逻辑 将 在 
FileInputStream 和 close 之 间 添 加 ， 装 作 一 切 正 常 的 样子 。 
尝试 编写 强行 抛 出 异常 的 测试 ， 再 往 人 处理 嚣 中 添加 行为 ， 使 之 满足 
测 斌 要求。 结果 就 是 你 要 先 构造 try 代 码 块 的 事务 范围 ， 而 且 也 会 帮助 你 
维护 好 该 范围 的 事务 特征 。 
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辩论 业已 结束 。 多 年 来 ，Java 程 序 员 们 一 直 在 争论 可 控 异 常 
(checked exception〉 的 利 与 次 。Java 的 第 一 个 版 本 中 引入 可 探 异 党 时 ， 
看 似 一 个 极 好 的 点 子 。 每 个 方法 的 签名 都 列 出 它 可 能 传递 给 调用 者 的 异 
第 。 而 且 ， 这 些 异常 就 是 方法 类 型 的 一 部 分 。 如 果 签 名 与 代码 实际 所 做 
之 事 不 符 ， 代 码 在 字面 上 就 无 法 编译 。 

那 时 ， 我 们 认为 可 控 异 常 是 个 绝妙 的 主意 ; 而 且 ， 它 也 有 所 神 益 。 
然而 ， 现 在 已 经 很 清楚 ， 对 于 强 固 软 件 的 生产 ， 它 并 非 必需 。C# 不 文 持 
可 控 异 常 。 尺 管 做 过 勇敢 的 尝试 ，C++ 最 后 也 不 支持 可 探 异 常 。Python 
和 Ruby 同 样 如 此 。 不 过 ， 用 这 些 语言 也 有 可 能 写 出 强 固 的 软件 。 我 们 得 
决定 一 一 的 确 如 此 可 探 异常 是 否 值 回 票 价 。 

代价 是 什么 ?可 控 异 常 的 代价 就 是 违反 开放 /闭合 原则 [1]。 如 果 你 
在 方法 中 抛 出 可 控 异 常 ， 而 catch 语 句 在 三 个 层级 之 上 ， 你 就 得 在 catch 
语句 和 抛 出 异常 处 之 间 的 每 个 方法 签名 中 声明 该 异常 。 这 意味 着 对 软件 
中 较 低 层级 的 修改 ， 都 将 波及 较 高 层级 的 签名 。 修 改 好 的 模块 必须 重新 
构建 、 发 布 ， 即 便 它 们 自 号 所 关注 的 任何 东西 都 没 改动 过 。 

以 某 个 大 型 系统 的 调用 层级 为 例 。 顶 端 函数 调用 它们 之 下 的 函数 ， 
级 向 下 。 假 设 某 个 位 于 最 底层 级 的 函数 被 修改 为 抛 出 一 个 异常 。 如 果 
均 异 各 是 可 控 的 ， 则 函数 签名 就 要 添加 throw 子 句 。 这 意味 着 每 个 调用 
该 阔 数 的 函数 都 要 修改 ， 捕 获 新 异常 ， 或 在 其 签名 中 添加 合适 的 throw 
子 句 。 以 此 类 推 。 最 终 得 到 的 就 是 一 个 从 软件 最 底 端 贯穿 到 最 高 端的 修 
改 链 ! 封装 被 打破 了 ， 因 为 在 抛 出 路 径 中 的 每 个 函数 都 要 去 了 解 下 一 层 
级 的 异常 细 市 。 既 然 异 常 时 在 让 你 能 在 较 远 处 处 理 错误 ， 可 控 异 和 常 以 这 
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种 方式 破坏 封装 简直 就 是 一 种 耻辱 。 
如 末 你 在 编写 一 套 关 键 代 码 库 ， 则 可 控 异 第 有 时 也 会 有 用 : 你 必须 
捕获 异常 。 但 对 于 一 般 的 应 用 开发 ， 其 依赖 成 本 要 局 于 收 荔 。 





PROBES RSS, ABD ef ABD, DAP RAY 
来 源 和 处 所 。 在 Java 中 ， 你 可 以 从 任何 异常 里 得 到 堆栈 踊 迹 (stack 
trace) ; 然而 ， 堆 栈 踪迹 却 无 法 告诉 你 该 失败 操作 的 初衷。 

应 创建 信息 充分 的 错误 消息 ， 并 和 异常 一 起 传递 出 去 。 在 消 恩 中 ， 
包括 失败 的 操作 和 失败 类 型 。 如 果 你 的 应 用 程序 有 日 志 系 统 ， 传 递 足够 
的 信息 给 catch 块 ， 并 记录 下 来 。 











对 错误 分 类 有 很 多 方式 。 可 以 依 其 来 源 分 类 
地 方 ? 或 依 其 类 型 分 

当 我 们 在 应 用 程序 中 
获 。 


型 分 


ZR: 





: 是 来 自 组 件 还 是 其 他 





是 设备 错误 、 网 络 错误 还 是 编程 错误 ? 不 过 ， 
定义 异 第 类 时 ， 最 重要 的 考虑 应 该 是 它们 如 何 被 捕 


来 看 一 个 不 太 好 的 异常 分 类 例子 。 下 面 的 try-catch-finally 语 句 是 对 
某 个 第 三 方 代码 库 的 调用 。 它 宪 盖 了 该 调用 可 能 抛 出 的 所 有 异 沼 : 


ACMEPort port = new ACMEPort(12); 
try { 
port.open(); 
} catch (DeviceResponseException e) { 
reportPortError(e); 
logger.log("Device response exception", e); 
} catch (ATM1212UnlockedException e) { 
reportPortError(e); 
logger.log("Unlock exception", e); 
} catch (GMXError e) { 
reportPortError(e); 
logger.log("Device response exception"); 
} finally { 


} 


语句 包含 了 一 大 堆 重 复 代码 ， 这 并 不 出 奇 。 在 大 多 数 异常 处 理 中 ， 


不 管 真实 原因 如 何 ， 我 们 总 是 做 相对 标准 的 处 理 。 我 们 得 记录 错误 ， 确 
保 能 继续 工作 。 
在 本 例 中 ， 既 然 知道 我 们 所 做 的 事 不 外 如 此 ， 惑 可 以 通过 打包 调用 
API、 确 保 它 返回 通用 有 异常 类 型 ， 从 而 简化 代码 。 
LocalPort port = new LocalPort(12); 
try { 
port.open(); 
} catch (PortDeviceFailure e) { 
reportError(e); 
logger.log(e.getMessage(), e); 
} finally { 


} 
LocalPort 类 区 是 个 简单 的 打包 类 ， 捕 获 并 翻译 由 ACMEPort 关 抛 出 
的 异常 : 
public class LocalPort { 
private ACMEPort innerPort; 
public LocalPort(int portNumber) { 
innerPort = new ACMEPort(portNumber); 
} 
public void open() { 
try { 
innerPort.open(); 
} catch (DeviceResponseException e) { 
throw new PortDeviceFailure(e); 
} catch (ATM1212UnlockedException e) { 


throw new PortDeviceFailure(e); 


} catch (GMXError e) { 
throw new PortDeviceFailure(e); 


} 


} 

类 似 我 们 为 ACMEPort 定 义 的 这 种 打包 类 非常 有 用 。 实 际 上 ， 将 第 
三 方 API 打 包 是 个 良好 的 实践 手段 。 当 你 打包 一 个 第 三 方 ”API， 你 就 降 
低 了 对 它 的 依赖 ， 未 来 你 可 以 不 太 痛 苗 地 改 用 其 他 代码 库 。 在 你 测试 目 
己 的 代码 时 ， 打 包 也 有 助 于 模拟 第 三 方 调用 。 

打包 的 好 处 还 在 于 你 不 必 绑 死 在 茶 个 特定 三 丙 的 API 设计 上 。 你 可 
以 定义 自己 感觉 舒服 的 API。 在 上 例 中 ， 我 们 为 port 设 备 错误 定义 了 一 
个 异 第 类 型 ， 然 后 发 现 这 样 能 写 出 更 整洁 的 代码 。 

对 于 代码 的 录 个 特定 区 域 ， 单 一 异常 类 通 沼 可行。 伴随 异常 友 送 出 
来 的 信息 能 够 区 分 不 同 错误 。 如 果 你 想 要 捕获 茶 个 异常 ， 并 且 放 过 其 他 
AR. MICENEI, 




















7.6 定义 常规 流程 


如 果 你 遵循 前 文 提 及 的 建议 ， 在 业务 逻辑 和 错误 处 理 代码 之 间 就 会 
有 民 好 的 区 阳 。 大 量 代码 会 开始 变 得 像 是 整洁 而 简朴 的 算法 。 然 而 ， 这 
样 做 却 把 错误 检测 推 到 了 程序 的 边缘 地 带 。 你 打包 了 外 部 API 以 抛 出 目 
己 的 异常 ， 你 在 代码 的 顶端 定义 了 一 个 处 理 占 来 应 付 任何 失败 了 的 运 
算 。 在 大 多 数 时 候 ， 这 种 手段 很 棒 ， 不 过 有 时 你 也 许 不 愿 这 么 做 。 

来 看 一 个 例子 。 下 面 的 笨 代 码 来 自作 个 记 账 应 用 的 开 文 总 计 模 块 : 








try { 
MealExpenses expenses = 


expenseReportDAO.getMeals(employee.getID()); 
m_total += expenses.getTotal(); 
} catch(MealExpensesNotFound e) { 
m_total += getMealPerDiem(); 
} 
WA Wee, WRIA SEE, WAR. WR AE, JI 
ASS A RAI FTT SUS ER. WR NEADS KT UL 
会 不 会 好 一 些 ? 那样 的 话 代码 看 起 来 会 更 简洁 。 就 像 这 样 : 


MealExpenses expenses = 








expenseReportDAO.getMeals(employee.getID()); 

m_total += expenses.getTotal(); 

能 把 代码 写 得 那样 简洁 吗 ? 能 。 可 以 修改 ExpenseReportDAO， 使 
其 总 是 返回 MealExpense 对 象 。 如 果 没 有 和 餐 食 消耗 ， 就 返回 一 个 返回 餐 
食补 贴 的 MealExpense 对 象 。 

public class PerDiemMealExpenses implements MealExpenses { 

public int getTotal() { 


// return the per diem default 


} 

这 种 手法 叫做 特例 模式 (SPECIAL CASE PATTERN, [FowlerD 。 
创建 一 个 类 或 配置 一 个 对 象 ， 用 来 处 理 特例 。 你 来 处 理 特例 ， 客 户 代 码 
束 不 用 应 付 异 常 行 为 了 。 和 异常 行为 被 封 疾 到 特例 对 象 中 。 





7.748 Finulé 


我 认为 ， 要 讨论 错误 处 理 ， 就 一 定 要 提 及 那些 容易 引发 错误 的 做 
法 。 第 一 项 就 是 返回 null 值 。 我 不 想 去 计算 曾经 见 过 多 少 几 乎 每 行 代 码 
都 在 检查 null 值 的 应 用 程序 。 下 面 就 是 个 例子 : 


public void registerItem(Item item) { 














if (item != null) { 
ItemRegistry registry = peristentStore.getItemRegistry(); 
if (registry != null) { 
Item existing = registry.getItem(item.getID()); 
if (existing.getBillingPeriod().hasRetailOwner()) { 


existing.register(item); 


} 

这 种 代码 看 似 不 坏 ， 其 实 糟 透 了 ! 返回 null 值 ， 基 本 上 是 在 给 自 
增加 工作 量 ， 也 是 在 给 调用 者 添乱 。 只 要 有 一 处 没 检查 null 值 ， Li 
序 就 会 失控 。 

TARARE), RE 证 语句 的 第 二 行 没 有 检查 null W? 如 果 在 运 
行 时 persistentStore 为 null 会 发 生 什么 事 ? 我 们 会 在 运行 时 得 到 一 个 
NullPointerException 异 常 ， 也 许 有 人 在 代码 顶端 捕获 这 个 异常 ， 也 可 能 
没有 捕获 。 de il 对 于 从 应 用 程序 深 处 抛 出 的 
NullPointerExceptionr A, 4E TZ TE f] cw Ue ? 








可 以 敷衍 说 上 列 代 码 的 问题 是 少 做 了 一 次 null 值 检查 ， 其 实 问题 多 
多 。 如 采 你 打算 在 方法 中 返回 null 值 ， 不 如 抛 出 异常 ， 或 是 返回 特例 对 
象 。 如 有 果 你 在 调用 某 个 第 三 方 API 中 可 能 返回 null 值 的 方法 ， 可 以 考虑 用 
新 方法 打包 这 个 方法 ， 在 新 方法 中 抛 出 异 弟 或 返回 特例 对 象 。 

在 许多 情况 下 ， 特 例 对 象 都 是 爽口 恨 药 。 设 想 有 这 么 一 段 代码 : 

List<Employee> employees = getEmployees(); 








if (employees != null) { 
for(Employee e : employees) { 
totalPay += e.getPay(); 


} 

现在 ，getExployees 可 能 返回 null， 但 是 否 一 定 要 这 么 做 呢 ? 如 果 修 
改 getEmployee， 返 回 空 列表 ， 就 能 使 代码 整洁 起 来 : 

List<Employee> employees = getEmployees(); 

for(Employee e : employees) { 

totalPay += e.getPay(); 

} 

Prs&Java/H Collections.emptyList( ) 方 法 ， 该 方法 返回 一 个 预定 义 不 
可 变 列 表 ， 可 用 于 这 种 目的 : 

public List<Employee> getEmployees() { 





if( .. there are no employees .. ) 
return Collections.emptyList(); 
} 
这 样 编码 ， 就 能 尽量 避免 NullPointerException 的 出 现 ， 代 人 码 也 就 更 


7.8 Jill {&}#null 


在 方法 中 返回 null 值 是 糟糕 的 做 法 ， 但 将 null 值 传递 给 其 他 方法 就 更 
糟 糕 了。 除非 API 要 求 你 向 它 传递 null 值 ， 否 则 就 要 尽 可 能 避免 传递 hull 
值 。 





举例 说 明 原 因 。 用 下 面 这 个 简单 的 方法 计算 两 点 的 投射 : 
public class MetricsCalculator 
{ 
public double xProjection(Point p1, Point p2) { 
return (p2.x — p1.x) * 1.5; 


} 
如 果 有 人 传 入 null 值 会 怎样 ? 
calculator.xProjection(null, new Point(12, 13)); 
当然 ， 我 们 会 得 到 一 个 NullPointerException 异 和 常 。 
如 何 修正 ? 可 以 创建 一 个 新 异常 类 型 并 抛 出 : 
public class MetricsCalculator 
{ 
public double xProjection(Point p1, Point p2) { 
if (p1 == null || p2 == null) { 
throw InvalidArgumentException( 


"Invalid argument for MetricsCalculator.xProjection"); 


return (p2.x — p1.x) * 1.5; 
} 

} 

这 样 做 好 些 吗 ? 可 能 比 null 指 针 异 常 好 一 些 ， 但 要 记 住 ， 我 们 还 得 
为 InvalidArgumentException 异 常 定义 处 理 器 。 这 个 处 理 器 该 做 什么 ?还 
有 更 好 的 做 法 吗 ? 

还 有 蔡 代 方案 。 可 以 使 用 一 组 断言 : 

public class MetricsCalculator 

{ 

public double xProjection(Point p1, Point p2) { 
assert p1 != null : "p1 should not be null"; 
assert p2 != null : "p2 should not be null"; 


return (p2.x — p1.x) * 1.5; 





} 

} 

看 上 去 很 美 ， 但 仍 未 解决 问题 。 如 果 有 人 传 入 null 值 ， 还 是 会 得 到 
运行 时 错误 。 


在 大 多 数 编 程 语言 中 ， 没 有 良好 的 方法 能 对 付 由 调用 者 意外 传 入 的 
null 值 。 事 已 如 此 ， 恰 当 的 做 法 就 是 禁止 传 入 null 值 。 这 样 ， 你 在 编码 的 
时 候 ， 就 会 时 时 记 住 参 数列 表 中 的 null 值 意味 着 出 问题 了 ， 从 而 大 量 避 
免 这 种 无 心 之 失 。 





7.9 "Zi 


整洁 代码 是 可 读 的 ， 但 也 要 强 固 。 可 读 与 强 固 并 不 冲突 。 如 果 将 错 
误 处 理 隅 离 看 等 ， 独 并 于 主要 逻辑 之 外 ， 束 能 写 出 强 固 而 整洁 的 代码 。 
做 到 这 一 步 ， 我 们 就 能 单独 处 理 它 ， 也 极 大 地 提升 了 代码 的 可 维护 性 。 
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我 们 很 少 控制 系统 中 的 全 部 软件 。 有 时 我 们 购买 第 三 方程 序 包 或 使 
用 开放 源 代码 ， 有 时 我 们 依靠 公司 中 其 他 团队 打造 组 件 或 子 系统 。 不 管 
古 哪 种 情况 ， 我 们 都 得 将 外 来 代码 干 滔 利落 地 整合 进 自 己 的 代码 中 。 本 
章 将 介绍 一 些 保持 软件 边界 整洁 的 实践 手段 和 技巧 。 


8.1 "S TV 





在 接口 提供 者 和 使 用 者 之 间 ， 存 在 与 生 俱 来 的 张力 。 第 三 方程 序 包 
和 框架 提供 者 追求 普 适 性 ， 这 样 就 能 在 多 个 环境 中 工作 ， 吸 引 广泛 的 用 
户 。 而 使 用 者 则 想 要 集中 满足 特定 需求 的 接口 。 这 种 张力 会 导致 系统 边 
界 上 出 现 问题 。 

以 java.util.Map 为 例 。 如 你 在 表 8-1 中 所 见 ，Map 有 着 广阔 的 接口 和 
丰富 的 功能 。 当 然 ， 这 种 力量 和 灵活 性 很 有 用 ， 但 也 要 付出 代价 。 比 
如 ， 应 用 程序 可 能 构造 一 个 Map 对 象 并 传递 它 。 我 们 的 初衷 可 能 是 Map 
对 象 的 所 有 接收 者 都 不 要 删除 映射 图 中 的 任何 东西 。 但 表 8-1 的 顶端 却 
正好 有 一 个 clear( ) 方 法 。Map 的 任何 使 用 者 都 能 清除 映射 图 。 或 许 设计 
惯例 是 Map 中 只 能 保存 特定 的 类 型 ， 但 Map 并 不 会 可 靠 地 约束 存 于 其 中 
的 对 象 的 类 型 。 使 用 者 可 随意 往 Map 中 寨 入 任何 类 型 的 条 目 。 











e clear() void - Map 

e containsKey(Object key) boolean - Map 

e containsValue (Object value) boolean - Map 

e entrySet() Set - Map 

e equals (Object o) boolean - Map 

e get(Object key) Object - Map 

e getClass() Class<? extends Object» - Object 

e hashCode() int - Map 

e isEmpty() boolean - Map 

e keySet() Set - Map 

e notify() void - Object 

© notifyAll() void - Object 

e put(Object key, Object value) Object - Map 

èe putAll(Map t) void - Map 

e remove(Object key) Object - Map 

e size() int - Map 

èe toString() String - Object 

* values() Collection - Map 

* wait() void - Object 

* wait(long timeout) void - Object 

e wait(long timeout, int nanos) void - Object 
图 8-1 Mop 类 的 方法 


如 果 你 的 应 用 程序 需要 一 个 包容 Sensor 类 对 象 的 Map 映 射 图 ， 大 概 


Map sensors = new HashMap(); 
当代 码 的 其 他 部 分 需要 访问 这 些 sensor， 就 会 有 这 行 代码 : 
Sensor s = (Sensor)sensors.get(sensorld ); 


KATA PED ASH ZETA A Map FRAR BaP hg 











转换 为 正确 类 型 的 职责 。 行 倒是 行 ， 却 并 非 整 洁 的 代码 。 而 且 ， 这 行 代 
码 并 未 说 明 目 己 的 用 途 。 通 过 对 泛 型 的 使 用 ， 这 段 代码 可 读 性 可 以 大 大 
denn, W BI: 


Map<Sensor> sensors = new HashMap<Sensor>(); 


Sensor s = sensors.get(sensorld ); 

不 过 ，Map<Sensor> 提 供 了 超出 所 需 / 所 愿 的 功能 的 问题 ， 仍 未 得 到 
解决 。 

在 系统 中 不 受 限制 地 传递 Map<Sensor> 的 实体 ， 意 味 着 当 到 Map 的 
接口 被 修改 时 ， 有 许多 地 方 都 要 跟着 改 。 你 或 许 会 认为 这 样 的 改动 不 太 
可 能 发 生 ， 不 过 ， 当 Java 5 加 入 对 泛 型 的 支持 时 ， 的 确 发 生 了 改动 。 我 
们 也 的 确 见 到 一 些 系 统 因为 要 做 大 量 改 动 才 能 自由 使 用 Map 类 ， 而 无 法 
使 用 泛 型 。 

使 用 Map 的 更 整洁 的 方式 大 致 如 下 。Sensors 的 用 户 不 必 关 心 是 否 
TZE, MÄ BiZE) 实现 细 节 才 关心 的 。 

public class Sensors { 

private Map sensors = new HashMap(); 

public Sensor getById(String id) { 
return (Sensor) sensors.get(id); 

} 

/片段 

} 

边界 上 的 接口 (Map) 是 隐藏 的 。 它 能 随 来 自 应 用 程序 其 他 部 分 的 
极 小 的 影响 而 变动 。 对 泛 型 的 使 用 不 再 是 个 大 问题 ， 因 为 转换 和 类 型 管 
理 是 在 Sensors 类 内 部 处 理 的 。 

该 接口 也 经 过 仔细 修整 和 归 置 以 适应 应 用 程序 的 需要 。 结 果 就 是 得 
到 易于 理解 、 难 以 被 误 用 的 代码 。Sensors 类 推动 了 设计 和 业务 的 规则 。 














BRANT FF AN EWC S ee DURA US Map EH. RATES BY 
Map 或 在 边界 上 的 其 他 接口 ) 在 系统 中 传递 。 如 采 你 使 用 类 似 Map 这 
样 的 边界 接口 ， 就 把 它 保 留 在 类 或 近 杀 类 中 。 避 免 从 公共 API 中 返回 边 
界 接 口 ， 或 将 边界 接口 作为 参数 传递 给 公共 API。 
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第 三 方 代码 帮助 我 们 在 更 少时 间 内 发 布 更 丰富 的 功能 。 在 利用 第 三 
方程 序 包 时 ， 访 从 何 处 入 手 呢 ? 我 们 没有 测试 第 三 方 代码 的 职责 ， 但 为 
要 使 用 的 第 三 方 代码 编写 测试 ， 可 能 最 符合 我 们 的 利益 。 

设想 第 三 方 代码 库 的 使 用 方法 并 不 清楚 。 我 们 可 能 会 伦 上 一 两 天 

(或 者 更 多 ) 时 间 阅 读 文 档 ， 决 定 如 何 使 用 。 然 后 ， 我 们 会 编写 使 用 第 
三 方 代 码 的 代码 ， 看 看 是 否 如 我 们 所 愿 地 工作 。 陷 入 长 时 间 的 调试 、 找 
出 在 我 们 或 他 们 代码 中 的 缺陷 ， 这 可 不 是 什么 稀罕 事 。 

学 习 第 三 方 代码 很 难 。 整 合 第 三 方 代码 也 很 难 。 同 时 做 这 两 件 事 难 
上 加 难 。 如 果 我 们 采用 不 同 的 做 法 呢 ?” 不 要 在 生产 代码 中 试验 新 东西 ， 
而 是 编写 测试 来 授 贤 和 理解 第 三 方 代码 。Jim Newkirk 把 这 叫做 学 习性 测 
试 (learning tests) 1。 

在 学 习性 测试 中 ， 我 们 如 在 应 用 中 那样 调用 第 三 方 代码 。 我 们 基本 
上 是 在 通过 核对 试验 来 检测 自己 对 那个 API 的 理解 程度 。 测 试 聚 焦 于 我 
们 想 从 API 得 到 的 东西 。 











8.3 学 必 log4j 


比如 ， 我 们 想 使 用 apache log4jH@ KRE BE MINA ERS. TT 
载 了 log4j， 打 开 介 绍 文档 页 。 无 需 看 太 久 ， 融 编写 了 第 一 个 测试 用 例 ， 
望 它 能 回 控 制 台 输出 hello 字 样 。 
@Test 
public void testLogCreate() { 
Logger logger = Logger.getLogger("MyLogger"); 
logger.info("hello"); 
} 
运行 ，logger 发 生 了 一 个 错误 ， 告 诉 我 们 需要 用 Appender。 再 多 读 
一 点 文档， 我 们 发 现 有 个 ConsoleAppender。 于 是 我 们 创建 了 一 个 
ConsoleAppender， 再 看 是 人 否 能 解 开 问 控制 台 输 出 日 志 的 秘诀 。 
@Test 
public void testLogAddAppender() { 
Logger logger = Logger.getLogger("MyLogger"); 
ConsoleAppender appender = new ConsoleAppender(); 
logger.addA ppender(appender); 
logger.info("hello"); 
} 
这 回 ， 我 们 发 现 Appender 没 有 输出 流 。 奇 怪 ， 它 该 有 输出 流 的 。 在 
Google 上 得 到 一 点 帮助 后 ， 我 们 写 了 以 下 代码 : 
@Test 
public void testLogAddAppender() { 





Logger logger = Logger.getLogger("MyLogger"); 
logger.removeAllAppenders(); 
logger.addA ppender(new ConsoleAppender( 
new PatternLayout("%p %t %m%n"), 
1 原 注 : [BeckTDD], pp. 136-137. 
ConsoleAppender.S YSTEM_OUT)); 
logger.info("hello"); 

} 

这 回 行 了 ; hello 字样 的 日 志 信 息 出 现在 控制 台 上 ! 必须 告知 
ConsoleAppender， 让 它 往 控制 台 写字 ， 看 起 来 有 点 奇怪 。 

很 有 趣 ， 当 我 们 移 除 ConsoleAppender.SystemOut 参 数 时 ， 那 个 
hello 字 样 仍然 输出 到 屏幕 上 。 但 如 果 取 走 PatternLayout， 就 会 出 现 关 于 
没有 输出 流 的 错误 信息 。 这 实在 太古 怪 了 。 

再 仔细 看 看 文档 ， 我 们 看 到 默认 的 ConsoleAppender 构造 器 是 “未 配 
置 ? 的 ， 这 看 起 来 并 不 明显 或 没什么 用 ， 反 而 像 是 log4j 的 一 个 缺陷 ， 或 
者 至 少 是 前 后 不 太一 致 。 

再 搜索 、 阅 读 、 测 试 ， 最 终 我 们 得 到 代码 清单 8-1。 我 们 极 大 地 发 
据 了 log4j 的 工作 方式 ， 也 将 得 到 的 知识 融入 了 一 系列 简单 的 单元 测试 
"m. 

代码 清单 8-1 LogTest.java 

public class LogTest { 











private Logger logger; 

@Before 

public void initialize() { 
logger = Logger.getLogger("logger"); 
logger.removeAllA ppenders(); 
Logger.getRootLogger().removeAllAppenders(); 


} 
@Test 
public void basicLogger() { 
BasicConfigurator.configure(); 
logger.info("basicLogger"); 
} 
@Test 
public void addAppenderWithStream() { 
logger.addAppender(new ConsoleAppender( 
new PatternLayout("%p %t %m%n"), 
ConsoleAppender.SYSTEM_OUT)); 
logger.info("addAppenderWithStream"); 
} 
@Test 
public void addAppenderWithoutStream() { 
logger.addAppender(new Console Appender( 
new PatternLayout("%p %t %m%n"))); 
logger.info("addAppenderWithoutStream"); 


} 

现在 我 们 知道 如 何 初始 化 一 个 简单 的 控制 台 日 志 器 ， 也 能 把 这 些 知 
识 封装 到 自己 的 日 志 类 中 ， 好 将 应 用 程序 的 其 他 部 分 与 log4j 的 边界 接口 
MEHR. 


8.4 ^£ 2] MEM K PARE qe 


学 习性 测试 之 无 成 本 。 无 论 如 何 我 们 都 得 学 习 要 使 用 的 API， 而 纺 
写 测试 则 是 获得 这 些 知识 的 容易 而 不 会 影响 其 他 工作 的 途径 。 学 习性 测 
试 是 一 种 精确 试验 ， 帮 助 我 们 增进 对 API 的 理解 

学 习性 测试 不 光 免 费 ， 还 在 投资 上 有 正面 的 回报 。 当 第 三 方程 序 包 
发 布 了 新 版 本 ， 我 们 可 以 运行 学 习性 测试 ， 看 看 程序 包 的 行为 有 没有 改 
变 。 

学 习性 测试 确保 第 三 方程 序 包 按照 我 们 想 要 的 方式 工作 。 一 旦 整合 
进来 ， 就 不 能 保证 第 三 方 代码 总 与 我 们 的 需要 兼容 。 原 作者 不 得 不 修改 
代码 来 满足 他 们 自己 的 新 需要 。 他 们 会 修正 缺陷 、 添 加 新 功能 。 风 险 伴 
随 新 版 本 而 来 。 如 果 第 三 方程 序 包 的 修改 与 测试 不 兼容 ， 我 们 也 能 马上 
发 现 。 

无 论 你 是 否 需 要 通过 学 习性 测试 来 学 习 ， 总 要 有 一 系列 与 生产 代码 
中 调用 方式 一 臻 的 输出 测试 来 支持 整洁 的 边界 。 不 使 用 这 些 边 界 测试 来 
减 经 迁移 的 劳力 ， 我 们 可 能 会 超出 应 有 时 限 ， 长 久 地 绑 在 旧版 本 上 面 。 

















还 有 另 一 种 边界 ， 那 种 将 已 知 和 未 知 分 隔 开 的 边界 。 在 代码 中 总 有 
许多 地 方 是 我 们 的 知识 未 及 之 处 。 有 时 ， 边 界 那 边 就 是 未 知 的 《至 少 目 
前 未 知 ) 。 有 时 ， 我 们 并 不 往 边 界 那 边 看 过 去 。 

好 多 年 以 前 ， 我 曾 在 一 个 开发 无 线 通 信和 系统 软件 的 团队 中 工作 。 该 
系统 有 个 子 系统 Transmitter〈 发 送 机 ) 。 我 们 对 Transmitter 知 之 甚 少 ， 
而 该 子 系统 的 开发 者 还 没有 对 接口 进行 定义 。 我 们 不 想 受 这 种 事 阻 碍 ， 
就 从 距 未 知 那 部 分 代码 很 远 处 开始 工作 。 

对 于 我 们 的 世界 如 何 结 束 、 新 世界 如 何 开 始 ， 我 们 有 许多 好 主意 。 
工作 时 ， 我 们 偶尔 会 跨越 那 道 边界 。 尽 管 云 圾 记 挡 了 我 们 看 向 边界 那 边 
的 视线 ， 我 们 还 是 从 工作 中 了 解 到 我 们 想 要 的 边界 接口 是 什么 样 的 。 我 
们 想 要 告知 发 送 机 一 些 事 : 

将 发 送 机 置 于 指定 频 紊 ， 并 发 出 自 这 个 流 得 到 的 数据 的 模拟 表示 。 

我 们 不 知 这 会 如 何 做 到 ， 因 为 API 还 没 设 计 出 来 。 所 以 ， 我 们 决定 
过 后 再 编写 细节 代码 。 

为 了 不 受阻 碍 ， 我 们 定义 了 自己 使 用 的 接口 。 我 们 给 它 取 了 个 好 记 
的 名 字 ， 比 如 Transmitter。 我 们 给 它 写 了 个 名 为 transmit 的 方法 ， 获 取 频 
率 参 数 和 数据 流 。 这 就 是 我 们 希望 得 到 的 接口 。 

编写 我 们 想得到 的 接口 ， 好 处 之 一 是 它 在 我 们 控制 之 下 。 这 有 助 于 
保持 客户 代码 更 可 读 ， 且 集中 于 它 该 完成 的 工作 。 

在 图 8-2 中 可 以 看 到 ， 我 们 将 CommunicationsController 类 从 发 送 器 
API (该 API 不 受 我 们 控制 ， 而 且 还 没 定义 〉 中 隔离 出 来 。 通 过 使 用 符 
合 应 用 程序 的 接口 ，CommunicationsController 代 码 整 洁 且 足以 表达 其 意 

















图 。 一 旦 发 送 器 API 被 定义 出 来 ， 我 们 就 编写 TransmitterAdapter 来 跨 
接 。ADAPTER[1] 封 狼 了 与 API 的 互动 ， 也 提供 了 一 个 当 API 发 生变 动 时 
唯一 需要 改动 的 地 方 。 


<<interface>> 
通信 控制 器 Transmitter 


+transmit (frequency, stream) 


vela Ahi Transmitter <<future>> 
图 8-2 对 发 送 器 的 预测 


这 套 设计 方案 为 测试 提供 了 一 种 极为 方便 的 接 颖 [2]。 使 用 适当 的 
FakeTransmitter， 我 们 就 能 测试 CommunicationsController 类 。 在 拿 到 
TransmitterAPI 时 ， 我 们 也 能 创建 确保 正确 使 用 API 的 边界 测试 。 









8.6 整洁 的 边界 








边界 上 会 发 生 有 趣 的 事 。 改 动 是 其 中 之 一 。 有 良好 的 软件 设计 ， 无 
需 巨 大 投入 和 重 写 即 可 进行 修改 。 在 使 用 我 们 控制 不 了 的 代码 时 ， 必 须 
加 倍 小 心 保 护 投 资 ， 确 保 未 来 的 修改 不 至 于 代价 太 大 。 

边界 上 的 代码 需要 清晰 的 分 制 和 定义 了 期 望 的 测试 。 应 该 避免 我 们 
的 代码 过 多 地 了 解 第 三 方 代 码 中 的 特定 信息 。 依 靠 你 能 控制 的 东西 ， 好 
过 依靠 你 控制 不 了 的 东西 ， 免 得 日 后 受 它 控制 。 

我 们 通过 代码 中 少数 几 处 引用 第 三 方 边界 接口 的 位 置 来 管理 第 三 方 
边界 。 可 以 像 我 们 对 待 Map 那 样 包 装 它 们 ， 也 可 以 使 用 ADAPTER 模 式 
将 我 们 的 接口 转换 为 第 三 方 提供 的 接口 。 采 用 这 两 种 方式 ， 代 码 都 能 
好 地 与 我 们 沟通 ， 在 边界 两 边 推动 内 部 一 致 的 用 法 ， 当 第 三 方 代 码 有 改 
动 时 修改 点 也 会 更 少 。 
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[BeckTDD]: Test Driven Development,Kent Beck, Addison- 
Wesley,2003. 

[GOF]: Design Patterns: Elements of Reusable Object Oriented 
Software, Gamma et al., Addison-Wesley, 1996. 

[WELC]: Working Effectively with Legacy Code,Addison- 
Wesley,2004. 





LL: 见 [GOF] 中 的 Adapter 模 式 。 
[2]. 原 注 : 在 [WELC] 中 可 查阅 更 多 关于 接 颖 (seam) 的 信息 。 
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过 去 十 年 以 来 ， 编 程 专业 领域 进步 很 大 。1997 年 时 ， 没 人 上 听 说 过 测 
试 驱动 开发 。 对 于 我 们 之 中 的 大 多 数 人 来 说 ， 蛙 元 测试 是 那 种 用 来 确保 
程序 “可 运行 ”的 用 过 即 扔 的 短 代 码 。 我 们 辛勤 地 编写 类 和 方法 ， 再 弄 出 
一 些 特殊 代 人 码 来 测试 它们 。 通 常 这 会 是 种 简单 的 驱动 式 程序 ， 让 我 们 能 
够 手工 与 自己 编写 的 程序 交互 。 

我 记得 在 20 世 纪 90 年 代 曾 为 一 套 租 入 式 实时 系统 编写 过 C++ 程 序 。 
该 程序 是 个 简单 的 计时 器 ， 有 如 下 签名 : 

void Timer::ScheduleCommand(Command*  theCommand, int 
milliseconds) 


想法 很 简单 ， 到 达 指 定 坚 秒 数 时 ， 在 一 个 新 线程 中 执行 Command 的 


excute 方 法 。 问 题 在 于 如 何 测试 它 。 

我 随便 写 了 个 简单 的 驱动 式 程序 ， 聆 听 来 目 键 盘 的 动作 。 键 盘 和 输入 
一 个 字符 时 ， 它 就 安排 5 秒 钟 乙 后 输出 同样 的 字符 。 我 输入 了 一 句 带 节 
FRR, AFASI Bv EB LEM TR, 

I... want-a-girl... just... like-the-girl-who-marr . . . ied... dear... 
old... dad.[1] 

TEE FABER BEY, RENDITE AREE, IUS) HUE BE 
幕 上 时 ， 我 又 再 呼 了 一 次 。 

那 就 是 我 的 测试 ! 我 看 到 这 法 子 可 行 ， 演 示 给 同事 们 看 ， 然 后 束 把 
代码 扔 掉 了 。 

如 前 文 所 述 ， 我 们 的 专业 领域 进步 甚 多。 如 今 ， 我 会 编写 测试 ， 确 
保 代 码 中 每 个 特 角 各 晃 都 如 我 所 愿 地 工作 。 我 会 将 代码 和 操作 系统 隔离 
开 ， 而 不 是 直接 调用 标准 计时 功能 。 我 会 伪造 一 套 计时 函数 ， 这 样 就 能 
全 面 控制 时 间 。 我 会 安排 一 些 设置 布尔 值 标 识 的 命令 ， 往 前 步 进 时 间 ， 
查看 这 些 标识 ， 确 保 它 们 在 我 将 时 间 调 到 正确 值 时 由 false 变 为 true。 

有 了 一 僚 运 行 通过 的 测试 ， 我 会 确保 任何 需要 用 到 代码 的 人 都 能 方 
便 地 使 用 这 些 测试 。 我 会 确保 测试 和 代码 一 起 签 入 同一 个 代码 包 。 

对 ， 我 们 进步 甚 多 ; 但 还 有 很 长 的 路 要 走 。 敏 捷 和 TDD jaa aoe 
了 许多 程序 员 编 写 自 动 化 单元 测试 ， 每 天 还 有 更 多 人 加 入 这 个 行列 。 但 
是 ， 在 争先 您 后 将 测试 加 入 规程 中 时 ， 许 多 程序 员 遗 漏 了 一 些 关 于 编写 
好 测试 的 更 细微 但 却 重 要 的 要 点 。 








9.1 TDD 三 定律 


谁 都 知道 TDD 要 求 我 们 在 编写 生产 代码 前 先 编写 单元 测试 。 但 这 条 
规则 只 是 冰山 之 题 。 看 看 下 列 三 定律 忆 ]: 

定律 一 在 编写 不 能 通过 的 单元 测试 前 ， 不 可 编写 生产 代码 。 

Ef — 只 可 编写 刚好 无 法 通过 的 单元 测试 ， 不 能 编译 也 算 不 通 














定律 三 只 可 编写 刚好 足以 通过 当前 失败 测试 的 生产 代码 。 

这 三 条 定律 将 你 限制 在 大 概 30 秒 一 个 的 循环 中 。 测 试 与 生产 代码 一 
起 编号， 测试 只 比 生产 代码 早 写 几 秒 钟 。 

这 样 写 程 序 ， 我 们 每 天 整 会 编写 数 十 个 测试 ， 每 个 月 编写 数 百 个 测 
试 ， 每 年 编写 数 干 个 测试 。 这 样 写 程 序 ， 测 试 将 窗 盖 所 有 生产 代码 。 测 
试 代码 量 足 以 匹敌 生产 代码 量 ， 导 致 令 人 生长 的 管理 问题 。 











9.2 地 测 试 整 法 


几 年 前 ， 有 人 请 我 去 指导 一 个 开发 团队 。 那 个 团队 认定 ， 测 试 代码 
的 维护 不 应 遵循 生产 代码 的 质量 标准 。 他 们 彼此 默许 在 单元 测试 中 破坏 
规矩 。“ 速 而 不 周 ? 成 了 团队 格言 。 变 量 命名 不 用 好 ， 测 试 函 数 不 必 短小 
和 上 共有 描述 性 。 测 试 代码 不 必 做 展 好 设计 和 仔细 划分 。 只 要 测试 代码 还 
能 工作 ， 只 要 还 履 兰 着 生产 代码 ， 就 足够 好 。 

有 些 读 者 可 能 会 同意 这 种 做 法 。 或 许 ， 在 很 久 以 前 ， 你 也 用 过 我 为 
那个 Timer 类 写 测试 的 方法 。 从 编写 那 种 用 后 即 扔 的 测试 到 编写 全 套 目 
动 化 单元 测试 是 一 大 进步 。 所 以 ， 束 像 那个 我 指导 过 的 团队 一 样 ， 你 或 
许 也 会 认为 脏 测 试 好 过 没 测试 。 

这 个 团队 没有 意识 到 的 是 ， 脏 测试 等 同 于 一 一 如 果 不 是 坏 于 的 话 
一 一 没 测试 。 问 题 在 于 ， 训 试 必须 随 生产 代码 的 演进 而 修改 。 测 试 越 
脏 ， 就 越 难 修 改 。 测 试 代码 越 缠 结 ， 你 残 越 有 可 能 花 更 多 时 间 墅 进 新 测 
试 ， 而 不 是 编写 新 生产 代码 。 修 改 生产 代码 后 ， 旧 测试 就 会 开始 失败 ， 
而 测试 代码 中 乱七八糟 的 东西 将 阻碍 代码 再 次 通过 。 于 是 ， 测 试 变 得 束 
Roe BEES FE o o 

随 着 版 本 递 进 ， 团 队 维 护 测试 代码 组 的 代价 也 在 上 升 。 最 终 ， 它 变 
成 了 开发 者 最 大 的 抱怨 对 象 。 当 经 理 们 问 及 为 何 超 支 如 此 巨大 ， 开 发 者 
们 就 归 答 于 测试 。 最 后 ， 他 们 只 能 扔 控 了 整个 测试 代码 组 。 

但 是 ， 没 有 了 测试 代码 组 ， 他 们 就 失去 了 确保 对 代码 的 改动 能 如 愿 
工作 的 能 力 。 没 有 了 测试 代码 组 ， 他 们 束 无 法 确保 对 系统 某 个 部 分 的 修 
改 不 会 影响 到 系统 的 其 他 部 分 。 故 障 率 开始 增加 。 随 着 并 非 出 自 有 意 的 
故障 越 来 越 多 ， 他 们 开始 害怕 做 改动 。 他 们 不 再 清理 生产 代码 ， 因 为 他 
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失望 。 

在 东 种 意义 上 ， 他 们 说 对 了 。 测 试 的 确 让 他 们 失望 。 不 过 是 他 们 目 
己 决 定 让 训 试 变 得 乱七八糟 的 ， 而 那 正 是 失败 的 根源 。 如 果 他 们 保持 测 
试 整洁 ， 测 试 就 不 会 令 他 们 失望 。 我 可 以 拍 痢 胸 肺 这 么 说， 因为 我 曾经 
参与 并 指导 了 多 个 凭借 整洁 单元 测试 获得 成 功 的 团队 。 

故事 的 寓意 很 简单 : 测试 代码 和 生产 代码 一 样 重要 。 它 可 不 是 二 等 
公民 。 它 需要 被 思考 、 被 设计 和 被 照料 。 它 该 像 生产 代码 一 般 保持 整 
洁 。 

测试 带 来 一 切 好 处 

如 末 测 试 不 能 保持 整洁 ， 你 融会 失去 它们 。 没 有 了 测试 ， 你 就 会 失 
去 保证 生产 代码 可 扩展 的 一 切 要 素 。 你 没 看 错 。 正 是 单元 测试 让 你 的 代 
码 可 扩展 、 可 维护 、 可 复 用 。 原 因 很 简单 。 有 了 测试 ， 你 束 不 担心 对 代 
码 的 修改 ! 没有 测试 ， 每 次 修改 都 可 能 市 来 缺陷 。 无 论 染 构 多 有 扩展 
性 ， 无 论 设计 划分 得 有 多 好 ， 没 有 了 测试 ， 你 就 很 难 做 改动 ， 因 为 你 担 
忧 改动 会 引入 不 可 预知 的 缺陷 。 

有 了 测试 ， 愁 云 一 扫 而 空 。 测 试 缆 凋 率 越 高 ， 你 就 越 不 担心 。 哪 介 
是 对 于 那 种 架构 并 不 优秀 、 设 计 星 涩 纠缠 的 代码 ， 你 也 能 近乎 没有 后 串 
地 做 修改 。 实 际 上 ， 你 能 坚 无 顾虑 地 改进 架构 和 设计 ! PD, Abie ^E 
产 代 码 的 自动 化 单元 测试 程序 组 能 尽 可 能 地 保持 设计 和 架构 的 整洁 。 测 
试 带 来 了 一 切 好 处 ， 因 为 测试 使 改动 变 得 可 能 。 

如 果 测 试 不 干净 ， 你 改动 目 己 代码 的 能 力 束 有 所 牵制 ， 而 你 也 会 开 
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丢失 了 测试 ， 代 码 开始 腐 坏 。 
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9.3 整洁 的 测试 


涪 的 测试 有 什么 要 素 ? ATER: 可 该 性 ， 可 读 性 和 可 读 性 。 


在 单元 测试 中 ， 可 读 性 甚至 比 在 生产 代码 中 还 重要 。 测 试 如 何 才 能 做 到 
可 读 ? 和 其 他 代码 中 一 样 : 明确 ， 简 洁 ， 还 有 足够 的 表达 力 。 在 测试 
中 ， 你 要 以 尽 可 能 少 的 文字 表达 大 量 内 容 。 

来 看 看 代码 清单 9-1 中 来 自 FitNesse 的 代码 。 这 三 个 测试 很 难 读 懂 ， 
显然 有 改善 空间 。 首 先 ， 其 中 有 数量 念 怖 的 重复 代码 [G5] 调 用 addPage 
和 assertSubString。 更 重要 的 是 ， 代 码 中 充满 了 干扰 测试 表达 力 的 细 
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代码 清单 9-1 SerializedPageResponderTest.java 
public void testGetPageHieratchyAsXml() throws Exception 


{ 


crawler.addPage(root, PathParser.parse("PageOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo")); 
request.setResource("root"); 
request.addInput("type", "pages"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 

(SimpleResponse) responder.makeResponse( 

new FitNesseContext(root), request); 

String xml = response.getContent(); 


assertEquals("text/xml", response.getContentType()); 


assertSubString("<name>PageOne</name>", xml); 
assertSubString("<name>PageTwo</name>", xml); 
assertSubString("<name>ChildOne</name>", xml); 
} 
public void testGetPageHieratchy AsXmlDoesntContainSymbolicLinks() 
throws Exception 
{ 
WikiPage pageOne = crawler.addPage(root, 
PathParser.parse("PageOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo")); 
PageData data = pageOne.getData(); 
WikiPageProperties properties = data.getProperties(); 
WikiPageProperty symLinks = 
properties.set(SymbolicPage.PROPERTY NAME); 
symL inks.set(" SymPage", "PageTwo"); 
pageOne.commit(data); 
request.setResource(" root"); 
request.addInput("type", "pages"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 
String xml = response.getContent(); 
assertEquals("text/xml", response.getContentType()); 
assertSubString("<name>PageOne</name>", xml); 


assertSubString(" «name» PageTwoc/name^", xml); 


assertSubString("<name>ChildOne</name>", xml); 
assertNotSubString("SymPage", xml); 

} 

public void testGetDataAsHtml() throws Exception 

{ 

crawler.addPage(root, PathParser.parse("TestPageOne"), "test page"); 
request.setResource("TestPageOne"); 
request.addInput("type", "data"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 

(SimpleResponse) responder.makeResponse( 

new FitNesseContext(root), request); 

String xml = response.getContent(); 
assertEquals("text/xml", response. getContentType()); 
assertSubString( "test page", xml); 
assertSubString("<Test", xml); 

} 

请 看 对 PathParser 的 那些 调用 。 它 们 将 字符 串 转 换 为 供 仆 虫 使 用 的 
PagePath 实 体 。 转 换 与 测试 早 无 关系 ， 徒 然 混 清 了 代码 的 意图 。 与 创建 
responder 相 关 的 细节 ， 还 有 response 的 收集 与 转换 也 尽 是 噪声 。 此 外 还 
有 从 resource 和 参数 构造 请 求 URL 的 笨 手 段 。〈 这 些 代码 我 有 洱 参 与 编 
写 ， 所 以 可 以 敞开 来 批评 。 ) 

最 终 ， 这 上 段 代 码 不 是 设计 来 给 人 看 的 。 可 怜 的 读者 淹没 在 细 市 的 汪 
洋 大 海中 ， 在 真正 用 到 测试 之 前 ， 还 得 理解 这 些 细 市 。 

现在 看 看 代码 清单 9-2 中 改进 了 的 测试 。 这 些 测试 还 是 做 一 样 的 
事 ， 不 过 已 经 被 重 构 为 更 整洁 和 有 表达 力 的 形式 。 

代码 清单 9-2 SerializedPageResponderTest.java (JE) 




















public void testGetPageHierarchyAsXml() throws Exception { 
makePages("PageOne", "PageOne.ChildOne", "PageTwo"); 
submitRequest( "root", "type:pages"); 
assertResponseIsXML(); 
assertResponseContains( 
"<name>PageOne</name>", "<name>PageTwo</name>", i 
<name>ChildOne</name>" 
); 
} 
public void testSymbolicLinksAreNotInXmlPageHierarchy() throws 
Exception { 
WikiPage page = makePage("PageOne"); 
makePages("PageOne.ChildOne", "PageTwo"); 
addLinkTo(page, "PageTwo", "SymPage"); 
submitRequest( "root", "type:pages"); 
assertResponseIsXML(); 


assertResponseContains( 


"<name>PageOne</name>", "<name>PageTwo</name>", E 
<name>ChildOne</name>" 
); 
assertResponseDoesNotContain("SymPage"); 


} 

public void testGetDataAsXml() throws Exception { 
makePageWithContent("TestPageOne", "test page"); 
submitRequest("TestPageOne", "type:data"); 
assertResponseIsXML(); 


assertResponseContains("test page", "<Test"); 


} 

这 些 测试 显然 呈现 了 构造 -操作 -检验 CBUILD-OPERATE- 
CHECK) [3] 模 式 。 每 个 测试 都 清晰 地 拆 分 为 三 个 环节 。 第 一 个 环节 构 
造 测试 数据 ， 第 二 个 环节 操作 测试 数据 ， 第 三 个 部 分 检验 操作 是 否 得 到 
期 望 的 结果 。 

注意 ， 那 些 恼 人 的 细节 大 部 分 消失 了 。 测 试 直达 目的 ， 只 用 到 那些 
真正 需要 的 数据 类 型 和 函数 。 读 测试 的 人 应 该 都 能 够 很 快 搞 清 楚 状 况 ， 
不 至 于 被 细节 误导 或 吓 倒 。 











代码 清单 9-2 中 的 测试 展示 了 为 测试 构造 一 种 面 癌 特定 领域 的 语言 
的 技巧 。 我 们 没有 和 直接 使 用 程序 员 用 来 对 系统 进行 操作 的 API， 而 是 打 
造 了 一 套 包 装 这 些 API 的 函数 和 工具 代码 ， 这 样 就 能 更 方便 地 编写 测 
试 ， 写 出 来 的 测试 也 更 便于 阅读 。 那 正 古 一 种 测试 语言 ， 可 以 帮助 程序 
员 编 写 自己 的 测试 ， 也 可 以 帮助 后 来 者 阅读 测试 。 

这 种 测试 API 并 非 起 初 束 设计 出 来 ， 而 是 在 对 那些 充满 令 人 迷惑 细 
节 的 训 试 代码 进行 后 续 重 构 时 逐渐 演进 。 如 同 你 看 见 我 将 代码 清单 9-1 
重 构 为 代码 清单 9-2 一 般 ， 和 守 规 矩 的 开发 者 也 将 他 们 的 训 试 代码 重 构 为 
更 简洁 和 具有 表达 力 的 形式 。 


9.3.2 双重 标准 


在 茶 种 意义 上 ， 本 半 开 始 处 提 到 的 那个 团队 的 做 法 是 正确 的 。 测 试 
API 中 的 代码 与 生产 代码 相 比 ， 的 确 有 一 套 不 同 的 工程 标准 。 测 试 代码 
应 当 简 单 、 精 悍 、 足 有 具 表达 力 ， 但 它 该 和 生产 代码 一 般 有 效 。 毕 竟 它 是 
在 测试 环境 而 非 生 产 环 境 中 运行 ， 这 两 种 环境 有 着 截 然 不 同 的 需求 。 

请 看 代码 清单 9-3 中 的 测试 。 在 为 人 条 个 环境 控制 系统 设计 原型 时 ， 














我 写 了 这 个 测试 。 无 需 深入 细节 ， 你 就 能 说 出 该 测试 在 "温度 太 低 时 检 
验 温 度 警 报 器 、 加 热 器 和 送 风机 是 否 全 部 打开 。 
代码 清单 9-3 EnvironmentControllerTest.java 
@Test 
public void turnOnLoTempAlarmAtThreashold() throws Exception { 
hw.setTemp(WAY_TOO_COLD); 
controller.tic(); 
assert True(hw.heaterState()); 
assert True(hw.blowerState()); 
assertFalse(hw.coolerState()); 
assertFalse(hw.hiTempAlarm()); 
assert True(hw.loTempAlarm()); 
} 
当然 ， 这 里 头 也 有 许多 细节 。 例 如 ，tic 函 数 是 做 什么 的 ? 实际 上 ， 
在 读 测 试 时 你 可 以 不 用 担心 这 些 问 题 。 你 只 需 考虑 是 否 同 意 系 统 最 终 状 
态 是 否 与 “温度 太 低 ” 的 情况 相符 。 
当 你 陪读 这 个 测试 时 ， 可 以 留意 到 上 自己 的 眼光 得 在 被 检验 的 状态 的 
名 称 与 状态 的 “意义 ”之 间 来 回 跳 转 。 你 看 到 heaterState， 有 眼光 辣 左 滑 到 
assertTrue。 你 看 到 coolerState， 有 眼光 同 左 看 assertFalse。 这 个 过 程 既 乏 味 
又 不 可 徘 。 它 让 测试 变 得 难以 阅读 。 
我 大 幅 改进 了 测试 的 可 读 性 ， 得 到 代码 清单 9-4。 
代码 清单 9-4 EnvironmentControllerTest.java 〈 重 构 后 ) 
@Test 
public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold(); 
assertEquals("HBchL", hw.getState()); 








当然 ， 我 创建 了 一 个 wayTooCold 函数 ， 隐 藏 了 tic 函数 的 细节 。 


不 过 要 注意 的 是 assertEquals 中 的 那个 奇怪 的 字符 串 。 大 写 表 示 “ 打 开 ”， 
小 写 表 示 "“ 关 闭 "”， 那 些 字 符 遵 循 以 下 次 序 : {heater，blower，cooler，hi- 


temp-alarm, lo-temp-alarm} 。 


的 。 


Ro 





尽管 这 破坏 了 思维 映射 [4] 的 规则 ， 看 来 它 在 这 种 情况 下 还 是 适用 
只 要 你 明白 其 含义 ， 你 残 能 一 眼看 到 那个 字符 串 ， 迅 速 译 解 出 结 


代码 清单 9-5 EnvironmentControllerTest.java (扩展 到 更 大 范围 ) 
@Test 

public void turnOnCoolerAndBlowerIfTooHot() throws Exception { 
tooHot(); 
assertEquals("hBChl", hw.getState()); 

} 

@Test 

public void turnOnHeaterAndBlowerIfTooCold() throws Exception { 
tooCold(); 
assertEquals("HBchl", hw.getState()); 

} 

@Test 

public void turnOnHiTempAlarmAtThreshold() throws Exception { 
wayTooHot(); 
assertEquals("hBCHI", hw.getState()); 

} 

@Test 

public void turnOnLoTempAlarmAtThreshold() throws Exception { 
wayTooCold(); 
assertEquals("HBchL", hw.getState()); 


} 
代码 清单 9-6 中 给 出 了 getState 函数 。 注 意 ， 人 代码 效率 不 是 非常 高 。 
要 提升 效率 ， 可 能 应 该 使 用 StringBuffer。 
代码 清单 9-6 MockControlHardware.java 
public String getState() { 











n", 


String state = ""; 
state += heater ? "H" : "h"; 
state += blower ? "B" : "b"; 
state += cooler ? "C" : "c"; 
state += hiTempAlarm ? "H" : "h"; 
state += loTempAlarm ? "L" : "1"; 
return state; 
j 
StringBuffer 有 点 丑陋 。 即 便 在 生产 代码 中 ， 假 使 代价 较 小 ， 我 都 会 
避免 使 用 StringBuffer; 而 且 你 可 以 看 到 ， 清 单 9-6 中 代码 的 代价 的 确 很 
小 。 这 套 应 用 显然 是 嵌入 式 实时 系统 ， 计 算 机 和 内 存 资源 都 很 有 限 。 不 
过 ， 测 试 环境 大 概 完全 不 必 做 限制 。 
这 就 是 双重 标准 。 有 些 事 你 大 概 水 远 不 会 在 生产 环境 中 做 ， 而 在 测 
试 环 境 中 做 却 完全 没 问 题 。 通 种 这 关乎 内 存 或 CPU 效率 的 问题 ， 不 过 却 
水 远 不 会 与 整洁 有 关 。 

















有 个 流派 [5] 认 为 ，JUnit 中 每 个 测试 函数 都 应 该 有 且 只 有 一 个 断言 





语句 。 这 条 规则 看 似 过 于 奇 求 ， 但 其 好 处 却 可 以 在 代码 清单 9-5 中 看 


到 。 


这 些 测试 都 归结 为 一 个 可 快速 方便 地 理解 的 结论 。 
代码 清单 9-2 又 如 何 ? 我 们 能 将 关于 输出 是 XML 的 断言 与 输出 包含 


某 些 子 字 符 串 的 断言 轻易 地 组 合 到 一 起 ， 不 过 这 样 做 看 来 坚 无 道理 。 然 


而 ， 


我 们 可 以 将 测试 分 解 为 两 个 单独 的 测试 ， 每 个 都 有 目 己 的 断言 ， 如 


代码 清单 9-7 所 示 。 


本 ) 


代码 清单 9-7 ^ SerializedPageResponderTest.java (单个 断言 的 版 


public void testGetPageHierarchyAsXml() throws Exception { 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 
whenRequestIsIssued("root", "type:pages"); 
thenResponseShouldBeXMI (); 
} 
public void testGetPageHierarchyHasRightTags() throws Exception { 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 
whenRequestIsIssued( "root", "type:pages"); 
thenResponseShouldContain( 
"<name>PageOne</name>", "<name>PageTwo</name>", E 
<name>ChildOne</name>" 


); 


注意 ， 我 修改 了 那些 函数 的 名 称 ， 以 符合 given-when-then[6] 约 定 。 
这 让 测试 更 易 阅 读 。 不 季 的 是 ， 如 此 分 解 测试 ， 导 致 了 许多 重复 代码 的 
出 现 。 

可 以 利用 模板 方法 (TEMPLATE METHOD) [7 了] 模式 ， 将 
given/when 部 分 放 到 基 类 中 ， 将 then 部 分 放 到 派生 类 中 ， 消 除 代 码 重复 
问题 。 或 者 ， 我 们 也 可 以 创建 一 个 完整 的 单独 测试 类 ， 把 given 和 when 
部 分 放 到 @Before 函 数 中 ， 把 when 部 分 放 到 每 个 @Test 函 数 中 。 但 对 于 
这 个 小 问题 ， 这 看 来 有 点 太 机 械 。 最 后 ， 我 还 是 保留 了 代码 清单 9-2 那 
种 多 个 断言 的 形式 。 

我 认为 ， 单 个 断言 是 个 好 准则 [8]。 我 通常 都 会 创建 文 持 这 条 ;准则 的 
寺 定 领域 测试 语言 ， 如 代码 清单 9-5 所 示 。 不 过 ， 我 也 不 害怕 在 单个 测 
试 中 放 入 一 个 以 上 断言 。 我 认为 ， 最 好 的 说 法 是 单个 测试 中 的 断言 数量 
应 该 最 小 化 。 

每 个 测试 一 个 概念 

更 好 一 些 的 规则 或 许 是 每 个 测试 函数 中 只 测试 一 个 概念 。 我 们 不 想 
要 超 长 的 测试 函数 ， 测 试 完 这 个 又 测 斌 那个。 代码 清单 9-8 束 是 那样 一 
种 测试 的 例子 。 这 个 测试 应 当 拆 解 为 3 个 单独 测试 ， 因 为 它 测 试 了 3 件 不 
同 的 事 。 把 三 者 混 到 一 起 ， 读 者 就 不 得 不 猜想 每 段 代 码 出 现 的 理由 ， 以 
及 那 段 代码 到 底 要 测试 什么 。 

代码 清单 9-8 


[** 








* Miscellaneous tests for the addMonths() method. 

*/ 

public void testAddMonths() { 
SerialDate d1 = SerialDate.createInstance(31, 5, 2004); 
SerialDate d2 = SerialDate.addMonths(1, d1); 
assertEquals(30, d2.getDayOfMonth()); 


assertEquals(6, d2.getMonth()); 
assertEquals(2004, d2.getY Y Y Y ()); 
SerialDate d3 = SerialDate.addMonths(2, d1); 
assertEquals(31, d3.getDayOfMonth()); 
assertEquals(7, d3.getMonth()); 
assertEquals(2004, d3.getY Y Y Y ()); 
SerialDate d4 = SerialDate.addMonths(1, SerialDate.addMonths(1, 
d1)); 
assertEquals(30, d4.getDayOfMonth()); 
assertEquals(7, d4.getMonth()); 
assertEquals(2004, d4.getY Y Y Y ()); 

j 

这 三 个 测试 函数 大 概 应 该 像 这 个 样子 : 

对 于 茶 个 有 31 天 的 月 份 的 最 后 一 天 《〈 如 五 月 ) : 

(1) 增加 一 个 该 月 份 最 末 一 天 为 30 日 〈 如 六 月 ) 的 月 份 时 ， 日 期 
应 该 是 该 月 的 30 日 而 非 31 日 。 
(2) 增加 最 末 月 有 31 天 的 两 个 月 时 ， 日 期 应 该 是 31 日 。 
对 于 茶 个 有 30 天 的 月 份 的 最 后 一 天 〈 如 六 月 ) : 
(3) 增加 一 个 有 31 天 的 月 份 时 ， 日 期 应 该 是 30 日 而 非 31 日 。 

这 样 一 来 ， 你 可 以 看 到 ， 在 这 些 混 杂 的 测 斌 当中， 隐藏 有 一 条 普 志 
规则 。 增 加 月 份 数 时 ， 日 期 不 能 大 于 该 月 份 的 最 末 一 天 。 这 意味 着 在 2 
月 28 日 增加 月 份 数 ， 就 会 得 到 3 月 28 日 。 而 这 个 测试 应 该 有 用 ， 但 被 遗 

并 非 是 代码 清单 9-8 中 每 个 段落 的 多 重 断 言 导 致 问题 。 问 题 在 于 ， 
有 多 个 概念 被 测试 ， 所 以 ， 最 佳 规则 也 许 是 应 该 尽 可 能 减少 每 个 概念 的 
条 言 数量 ， 每 个 测试 函数 只 测试 一 个 概念 。 




















[9] 
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jel: 


快速 (Fast) ”测试 应 该 够 快 。 测 试 应 该 能 快速 运行 。 测 试 运行 组 
慢 ， 你 残 不 会 想 要 频繁 地 运行 它 。 如 果 你 不 频繁 运行 测试 ， 束 不 能 义 早 
发 现 问题 ， 也 无 法 轻易 修正 ， 从 而 也 不 能 轻而易举 地 清理 代码 。 最 终 ， 
代码 就 会 腐 坏 。 

独立 〈Independent) 测试 应 该 相互 独立 。 某 个 测试 不 应 为 下 一 个 测 
试 设 定 条 件 。 你 应 该 可 以 单独 运行 每 个 测试 ， 及 以 任何 顺序 运行 测试 。 
当 测 试 互相 依赖 时 ， 头 一 个 没 通过 束 会 导致 一 连 串 的 测试 失败 ， 使 问题 
诊断 变 得 困难 ， 隐 藏 了 下 级 错误 。 

可 重复 〈Repeatable) 测试 应 当 可 在 任何 环境 中 重复 通过 。 你 应 该 
能 够 在 生产 环境 、 质 检 环 境 中 运行 测试 ， 也 能 够 在 无 网 络 的 列车 上 用 笔 
记 本 电脑 运行 测试 。 如 果 测 试 不 能 在 任意 环境 中 重复 ， 你 就 总 会 有 个 解 
释 其 失败 的 接口 。 当 环境 条 件 不 具备 时 ， 你 也 会 无 法 运行 测试 。 

上 自足 验证 CSelf-Validating) 测试 应 该 有 布尔 值 输出 。 无 论 是 通过 
或 失败 ， 你 不 应 该 查看 日 志文 件 来 确认 测试 是 否 通 过 。 你 不 应 该 手工 对 
比 两 个 不 同文 本 文件 来 确认 测试 是 否 通过 。 如 果 测 试 不 能 自足 验证 ， 对 
失败 的 判断 就 会 变 得 依赖 主观 ， 而 运行 测试 也 需要 更 长 的 手工 操作 时 
间 。 

Ki} (Timely) 测试 应 及 时 编写 。 单 元 测试 应 该 恰好 在 使 其 通过 的 
生产 代码 之 前 编写 。 如 果 在 编写 生产 代码 之 后 编写 测试 ， 你 会 发 现 生产 


























代码 难以 测试 。 你 可 能 会 认为 菜 些 生 产 代 码 本 里 难以 测试 。 你 可 能 不 会 
去 设计 可 测试 的 代码 。 


9.6 小 结 


我 们 只 是 触及 了 这 个 话题 的 表面 。 实 际 上 ， 我 认为 应 该 为 整洁 的 测 
试 写 上 一 整 本 书 。 对 于 项 目的 健康 度 ， 测 试 盒 生 产 代码 同等 重要 。 或 许 
测试 更 为 重要 ， 因 为 它 保证 和 增强 了 生产 代码 的 可 扩展 性 、 可 维护 性 和 
可 复 用 性 。 所 以 ， 保 持 测试 整洁 吧 。 让 测试 具有 表达 力 并 短小 精 悍 。 发 
明 作 为 面 癌 特定 领域 语言 的 测试 API， 帮 助 目 己 编写 测试 。 

如 果 你 坐视 测试 腐 坏 ， 那 么 代码 也 会 跟着 腐 坏 。 保 持 测 试 整 洁 吧 。 








y Y 


9.7 


[RSpec]: RSpec: Behavior Driven Development for Ruby 
Programmers, Aslak Hellesøy, David Chelimsky, Pragmatic Bookshelf, 
2008. 

[GOF]: Design Patterns: Elements of Reusable Object Oriented 
Software, Gamma et al., Addison-Wesley, 1996. 





[11. 译 注 : I want a girl just like the girl who married dear old dad 是 20 世 纪 
#J] American Quartet 四 重唱 乐队 的 歌曲 名 ， 也 是 歌词 中 的 一 句 ， 这 里 不 做 


翻 详 。 


[21. 原 注 : Professionalism and Test-Driven Development, Robert C. Martin, 
Object Mentor, IEEE Software, May/June 2007 (Vol. 24, No. 3) pp. 32-36. 


[3]. 原 注 : http://fitnesse.org/FitNesse.AcceptanceTestPatterns. 
[41. 原 注 : 见 第 2 章 。 


[51. 原 注 : 见 Dave Astel 的 blog 文 章 : 
http://www.artima.com/weblogs/viewpost.jsp?thread=35578, 


[6]. 原 注 : [RSpec]. 
[Z]. 原 注 ，[GOF]。 





[8]. 原 注 : “ 照 规矩 办 (Keep to the code) !22【 译 者 按 】 这 是 电影 《加 勒 
比 海盗》 中 的 一 名 台词。 


[9]. 原 注 : 参见 Object Mentor ill AF 


与 Jeff Langr 合 写 





本 书 到 目前 为 止 一 直 在 讨论 如 何 编写 恨 好 的 代码 行 和 代码 块 。 我 们 
深入 研究 了 函数 的 恰当 构成 ， 以 及 函数 之 间 如 何 互 相关 联 。 不 过 ， 尽 管 
讨论 了 这 么 多 关于 代码 语句 及 由 代码 语句 构成 的 函数 的 表达 力 ， 除 非 我 








们 将 注意 力 放 到 代码 组 织 的 更 高 层面 ， 就 始终 不 能 得 到 整洁 的 代码 。 


10.1 类 的 组 织 











变量 。 
函数 应 跟 在 变量 列表 之 后 。 我 们 喜欢 把 由 茶 个 公共 函数 调用 的 
私有 工具 函数 紧 随 在 该 公共 函数 后 面 。 这 符合 了 自 顶 辐 下 原则 ， 让 程序 
读 起 来 束 像 一 篇 报纸 文章 。 

封装 

我 们 喜欢 保持 变量 和 工具 函数 的 私有 性 ， 但 并 不 执着 于 此 。 有 时 ， 
我 们 也 需要 用 到 受 护 〈protected) 变量 或 工具 函数 ， 好 让 测试 可 以 访问 
到 。 对 我 们 来 说 ， 测 试 说 了 算 。 大 同一 程序 包 内 的 某 个 测试 需要 调用 一 
个 函数 或 变量 ， 我 们 束 会 将 该 函数 或 变量 置 为 受 护 或 在 整个 程序 包 内 可 
访问 。 然 而 ， 我 们 首先 会 想 办 法 使 之 保有 隐私 。 放 松 封 效 总 是 下 集 。 
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10.2 类 应 该 短小 





关于 类 的 第 一 条 规则 是 类 应 该 短小 。 第 二 条 规则 是 还 要 更 短小 。 
不 ， 我 们 并 不 是 要 重 弹 “水 数 ” 一 章 的 论调 。 就 像 函 数 一 样 ， 在 设计 类 
时 ， 前 要 规 条 就 是 要 更 短小 。 和 疯 数 一 样 ， 马 上 有 个 问题 出 现 ， 那 就 
是 “多 小 合适 呢 ?” 

对 于 函数 ， 我 们 通过 计算 代码 行 数 衡量 大 小 。 对 于 类 ， 我 们 采用 不 
同 的 衡量 方法 ， 计 算 权 责 Cresponsibility) [1]. 

代码 清单 10-1 给 出 了 某 个 类 的 轮廓 。SuperDashboard 类 曝露 大 概 70 
个 公共 方法 。 大 多 数 开发 者 都 会 同意 ， 这 实在 是 太 长 了 。 有 些 开发 者 或 
许 会 将 SuperDashboard 类 指 为 “ 神 的 类 ”。 

代码 清单 10-1 权 责 太 多 


public class SuperDashboard extends JFrame implements MetaDataUser 





public String getCustomizerLanguagePath() 

public void setSystemConfigPath(String systemConfigPath) 

public String getSystemConfigDocument() 

public void setSystemConfigDocument(String 
systemConfigDocument) 

public boolean getGuruState() 

public boolean getNoviceState() 

public boolean getOpenSourceState() 

public void showObject(MetaObject object) 
public void showProgress(String s) 


public boolean isMetadataDirty() 


public void setIsMetadataDirty(boolean isMetadataDirty) 
public Component getLastFocusedComponent() 

public void setLastFocused(Component lastFocused) 
public void setMouseSelectState(boolean isMouseSelected) 
public boolean isMouseSelected() 

public LanguageManager getLanguageManager() 

public Project getProject() 

public Project getFirstProject() 

public Project getLastProject() 

public String getNewProjectName() 

public void setComponentSizes(Dimension dim) 

public String getCurrentDir() 

public void setCurrentDir(String newDir) 

public void updateStatus(int dotPos, int markPos) 

public Class[] getDataBaseClasses() 

public MetadataFeeder getMetadataFeeder() 

public void addProject(Project project) 

public boolean setCurrentProject(Project project) 

public boolean removeProject(Project project) 

public MetaProjectHeader getProgramMetadata() 

public void resetDashboard() 

public Project loadProject(String fileName, String projectName) 
public void setCanSaveMetadata(boolean canSave) 
public MetaObject getSelectedObject() 

public void deselectObjects() 

public void setProject(Project project) 


public void editorAction(String actionName, ActionEvent event) 


public void setMode(int mode) 
public FileManager getFileManager() 
public void setFileManager(FileManager fileManager) 
public ConfigManager getConfigManager() 
public void setConfigManager(ConfigManager configManager) 
public ClassLoader getClassLoader() 
public void setClassLoader(ClassLoader classLoader) 
public Properties getProps() 
public String getUserHome() 
public String getBaseDir() 
public int getMajorVersionNumber() 
public int getMinorVersionNumber() 
public int getBuildNumber() 
public MetaObject pasting( 
MetaObject target, MetaObject pasted, MetaProject project) 
public void processMenultems(MetaObject metaObject) 
public void processMenuSeparators(MetaObject metaObject) 
public void processTabPages(MetaObject metaObject) 
public void processPlacement(MetaObject object) 
public void processCreateLayout(MetaObject object) 
public void updateDisplayLayer(MetaObject object, int layerIndex) 
public void propertyEditedRepaint(MetaObject object) 
public void processDeleteObject(MetaObject object) 
public boolean getAttachedToDesigner() 
public void processProjectChangedState(boolean hasProjectChang) 
public void processObjectNameChanged(MetaObject object) 


public void runProject() 


public void setAgowDragging(boolean allowDragging) 

public boolean allowDragging() 

public boolean isCustomizing() 

public void setTitle(String title) 

public IdeMenuBar getIdeMenuBar() 

public void — showHelper(MetaObject ^ metaObject, String 
propertyName) 

// ... many non-public methods follow ... 


j 
如 果 SuperDashboard 类 只 包括 代码 清单 10-2 中 的 方法 呢 ? 
代码 清单 10-2 足够 短小 了 吗 ? 
public class SuperDashboard extends JFrame implements 
MetaDataUser{ 
public Component getLastFocusedComponent() 





public void setLastFocused(Component lastFocused) 
public int getMajorVersionNumber() 
public int getMinorVersionNumber() 


public int getBuildNumber() 





} 
5 个 方法 不 算 多 ， 在 这 里 ， 虽 然 方法 数量 较 少 ， 可 SuperDashboard 还 
是 拥有 太 多 权 贡 。 


类 的 名 称 应 当 描述 其 权 责 。 实 际 上 ， 命 名 正 是 帮助 判断 类 的 长 度 的 
第 一 个 手段 。 如 采 无 法 为 某 个 类 命 以 精确 的 名 称 ， 这 个 类 大 概 就 太 长 
了 。 类 名 越 合 混 ， 该 类 越 有 可 能 拥有 过 多 权 员 。 例如， 如 果 类 名 中 包括 
含义 模糊 的 词 ， 如 Processor 或 Manager 或 Super， 这 种 现象 往往 说 明 有 不 
恰当 的 权 责 聚集 情况 存在 。 

我 们 也 应 该 能 够 用 大 概 25 个 单词 简要 描述 一 个 类 ， 且 不 用 “大 





(D ". “E Cand) ”, “BK Cor) ”或 者 “但 (but) ”等 词汇 。 我 们 该 如 
何 描述 SuperDashboard 类 呢 ?“SuperDashboard 类 提供 了 对 最 后 拥有 焦 
点 的 组 件 的 访问 能 力 ， 我 们 还 能 通过 它 跟 踩 版 本 号 和 构建 序列 写 。” 还 
能 ”二 字 正 好 提示 了 SuperDashboard 类 有 太 多 权 责 。 


10.2.1 单一 权 责 原 见 


单一 权 责 原则 (SRP) 思 ] 认 为 ， 类 或 模块 应 有 且 只 有 一 条 加 以 修改 
的 理由 。 该 原则 既 给 出 了 权 责 的 定义 ， 又 是 关于 类 的 长 度 的 指导 方针 。 
类 只 应 有 一 个 权 责 只 有 一 条 修改 的 理由 。 

代码 清单 10-2 中 貌似 很 小 的 SuperDashboard 类 有 两 条 加 以 修改 的 理 
由 。 首 先 ， 它 跟 踊 大概 会 随 软 件 每 次 发 布 而 更 新 的 版 本 信息 。 第 二 ， 它 
管理 Java Swing 组 件 (派生 自 Jrame， 顶 层 GUI 窗 口 的 Swing 表 现形 
A) 。 每 次 修改 Swing 代 码 时 ， 无 疑 都 要 更 新 版 本 号 ， 但 反之 未 必 可 
行 : 也 可 能 依据 系统 中 其 他 代码 的 修改 而 更 新 版 本 信息 。 

鉴别 权 员 (修改 的 理由 )〉 常 党 帮助 我 们 在 代码 中 认识 到 并 创建 出 更 
好 的 抽象 。 可 以 轻易 地 将 全 部 三 个 处 理 版 本 信息 的 SuperDashboard 方 法 
拆 解 到 名 为 Version 的 类 中 《如 代码 清单 10-3 所 示 ) 。Version 类 是 个 极 有 
可 能 在 其 他 应 用 程序 中 得 到 复 用 的 构造 ! 

代码 清单 10-3 单一 权 责 类 


public class Version { 





public int getMajorVersionNumber() 
public int getMinorVersionNumber() 
public int getBuildNumber() 
} 
SRP 是 OO 设计 中 最 为 重要 的 概念 之 一 ， 也 是 较为 容易 理解 和 遵循 
的 概念 之 一 。 奇 怪 的 是 SRP 往 往 也 是 最 容易 被 破坏 的 类 设计 原则 。 经 名 


会 遇 到 做 太 多 事 的 类 。 为 什么 呢 ? 

让 软件 能 工作 和 让 软件 保持 整洁 ， 是 两 种 截然 不 同 的 工作 。 我 们 中 
的 大 多 数 人 脑力 有 限 ， 只 能 更 多 地 把 精力 放 在 让 代码 能 工作 上 ， 而 不 是 
放 在 保持 代码 有 组 织 和 整洁 上 。 这 全 然 正确 。 分 而 治之 ， 其 在 编程 行为 
中 的 重要 程度 等 同 于 在 程序 中 的 重要 程度 。 

问题 是 太 多 人 在 程序 能 工作 时 束 以 为 万 事 大 吉 了。 我 们 没 能 把 思维 
转向 有 关 代 人 码 组 织 和 整洁 的 部 分 。 我 们 直接 转向 下 一 个 问题 ， 而 不 是 回 
头 将 脆 肿 的 关切 分 为 只 有 单一 权 责 的 去 耦 式 单 元 。 

与 此 同时 ， 许 多 开发 者 害怕 数量 巨大 的 短小 单一 目的 类 会 导致 难以 
一 目 了 然 抓 住 全 局 。 他 们 认为 ， 要 搞 清楚 一 件 较 大 工作 如 何 完成 ， 就 得 
在 类 与 类 之 间 找 来 找 去 。 

然而 ， 有 大 量 短小 类 的 系统 并 不 比 有 少量 庞大 类 的 系统 拥有 更 多 移 
动 部 件 ， 其 数量 大 致 相等 。 问 题 是 : 你 是 想 把 工具 归 置 到 有 许多 抽 屋 、 
每 个 抽 屠 中 装 有 定义 和 标记 良好 的 组 件 的 工具 箱 中 呢 ， 还 是 想 要 少数 几 
个 能 随便 把 所 有 东西 扔 进去 的 抽 屠 ? 

每 个 达到 一 定 规模 的 系统 都 会 包括 大 量 多 辑 和 复杂 性 。 管 理 这 种 复 
杂 性 的 首要 目标 就 是 加 以 组 织 ， 以 便 开 发 者 知道 到 哪儿 能 找到 东西 ， 并 
且 在 茶 个 特定 时 间 只 需要 理解 直接 有 关 的 复杂 性 。 反 之 ， 拥 有 巨大 、 多 
目的 类 的 系统 ， 总 是 让 我 们 在 目前 并 不 需要 了 解 的 一 大 堆 东 西 中 艰难 跌 
涉 。 

再 强调 一 下 : 系统 应 该 由 许多 短小 的 类 而 不 是 少量 巨大 的 类 组 成 。 
每 个 小 类 封装 一 个 权 黄 ， 只 有 一 个 修改 的 原因 ， 并 与 少数 其 他 类 一 起 协 
同 达成 期 望 的 系统 行为 。 









































Rpg, wma, ZITATRÍEHJARSUEOE, RRR BIAS E. WR— 
个 类 中 的 每 个 变量 都 被 每 个 方法 所 使 用 ， 则 该 类 具有 最 大 的 内 聚 性 。 

一 般 来 说 ， 创 建 这 种 极 大 化 内 聚 类 是 既 不 可 取 也 不 可 能 的 ， 男 一 方 
面 ， 我 们 希望 内 聚 性 保持 在 较 高 位 置 。 内 聚 性 高 ， 意 味 着 类 中 的 方法 和 
变量 互相 依赖 、 互 相 结 合成 一 个 逻辑 整体 。 

看 看 代码 清单 10-4 中 一 个 Stack 类 的 实现 方式 。 这 个 类 非常 内 聚 。 在 
三 个 方法 中 ， 只 有 size( ) 方 法 没有 使 用 所 有 两 个 变量 。 

代码 清单 10-4 Stack.java 一 个 内 聚 类 ) 

public class Stack { 











private int topOfStack = 0; 
List<Integer> elements = new LinkedList<Integer>(); 
public int size() { 
return topOfStack; 
} 
public void push(int element) { 
topOfStack++; 
elements.add(element); 
} 
public int pop() throws PoppedWhenEmpty { 
if (topOfStack == 0) 
throw new PoppedWhenEmpty(); 
int element = elements.get(--topOfStack); 
elements.remove(topOfStack); 


return element; 


} 
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的 实体 变量 数量 增加 。 出 现 这 种 情况 时 ， 往 往 意 味 痢 至 少 有 一 个 类 要 从 
大 类 中 挣扎 出 来 。 你 应 当 冬 试 将 这 些 变量 和 方法 分 拆 到 两 个 或 多 个 类 
中 ， 让 新 的 类 更 为 内 聚 。 














仅仅 是 将 较 大 的 函数 切割 为 小 函数 ， 就 将 导致 更 多 的 类 出 现 。 想 想 
看 一 个 有 许多 变量 的 大 函数 。 你 想 把 该 函数 中 某 一 小 部 分 拆 解 成 单独 的 
函数 。 不 过 ， 你 想 要 拆 出 来 的 代码 使 用 了 该 函数 中 声明 的 4 个 变量 。 是 
盏 必须 将 这 4 个 变量 都 作为 参数 传递 到 新 函数 中 去 呢 ? 

完全 没 必 要 ! 只 要 将 4 个 变量 提升 为 类 的 实体 变量 ， 完 全 无 需 传递 
任何 变量 惑 能 拆 解 代 码 了 。 应 该 很 容易 将 函数 拆 分 为 小 块 。 

可 惜 这 也 意味 着 类 丧失 了 内 聚 性 ， 因 为 堆积 了 越 来 越 多 只 为 允许 少 
量 函数 共享 而 存在 的 实体 变量 。 等 一 下 ! 如 果 有 些 函 数 想 要 共享 某 些 变 
量 ， 为 什么 不 让 它们 拥有 自己 的 类 呢 ? BREAST ARE, MRE! 

所 以 ， 将 大 函数 拆 为 许多 小 函数 ， 往 往 也 是 将 类 拆 分 为 多 个 小 类 的 
时 机 。 程 序 会 更 加 有 组 织 ， 也 会 拥有 更 为 透明 的 结构 。 

为 了 说 明 我 的 意思 ， 不 如 从 Knuth 的 名 著 Literate Programming CP 
译 版 《字面 编程 》) [3] 中 摘 取 一 个 经 过 时 间 考 验 的 例子 。 代 码 清单 10-5 
展示 Knuth 的 PrintPrimes 程 序 的 Java 版 本 。 为 示 公 平 ， 以 下 程序 并 非 
Knuth 原 版 ， 而 是 用 他 的 WEB 工 具 输出 的 版 本 。 采 用 它 作 为 例子 的 目 
的 ， 是 因为 它 是 展示 如 何 将 较 大 的 函数 分 解 为 多 个 较 小 的 函数 和 类 的 极 
好 入 手 点 。 

代码 清单 10-5 PrintPrimes.java 


package literatePrimes; 


























public class PrintPrimes { 


public static void main(String[] args) { 


final int M = 1000; 

final int RR = 50; 

final int CC = 4; 

final int WW = 10; 

final int ORDMAX = 30; 
int P[] = new int[M + 1]; 
int PAGENUMBER; 

int PAGEOFFSET; 

int ROWOFFSET; 

int G; 

int J; 

int K; 

boolean JPRIME; 

int ORD; 

int SQUARE; 

int N; 

int MULTI] = new inttORDMAX + 1]; 


SQUARE = 9; 
while (K < M) { 
do { 
J=J+2; 
if (J == SQUARE) { 
ORD = ORD + 1; 


SQUARE = P[ORD] * P[ORD]; 
MULT[ORD - 1] = J; 
} 
N = 2; 
JPRIME = true; 
while (N < ORD && JPRIME) { 
while (MULT[N] < J) 
MULT[N] = MULT[N] + PIN] + PLN]; 
if (MULT[N] == J) 
JPRIME = false; 
N=N+1; 
} 
} while (!JPRIME); 
K=K+1; 
P[K] = J; 


PAGENUMBER = 1; 
PAGEOFFSET = 1; 
while (PAGEOFFSET <= M) { 
System.out.println("The First "+ M + 
" Prime Numbers --- Page " + 
PAGENUMBER); 
System.out.println(""); 
for (ROWOFFSET = PAGEOFFSET; ROWOFFSET < 
PAGEOFFSET + RR; ROWOFFSET++){ 
for (C = 0; C < CC;C++) 


if (ROWOFFSET + C * RR <= M) 
System.out.format("%10d", P[ROWOFFSET + C * 
RRJ); 
System.out.println(""); 
} 
System.out.println("\f"); 
PAGENUMBER = PAGENUMBER + 1; 
PAGEOFFSET = PAGEOFFSET + RR * CC; 


} 
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从 代码 清单 10-6 到 代码 清单 10-8， 展 示 了 将 代码 清单 10-5 中 的 代码 
拆 分 为 较 小 的 类 和 函数 ， 并 为 这 些 类 、 函 数 和 变量 取 个 好 名 字 后 的 结 
果 。 





代码 清单 10-6 PrimePrinter.java (XX 4 Jc? 

package literatePrimes; 

public class PrimePrinter { 

public static void main(String[] args) 1 
final int NUMBER, OF PRIMES = 1000; 
int[] primes = PrimeGenerator.generat(NUMBER OF PRIMES); 
final int ROWS PER, PAGE = 50; 
final int COLUMNS PER PAGE - 4; 
RowColumnPagePrinter tablePrinter = 
new RowColumnPagePrinter(ROWS PER, PAGE, 


COLUMNS_PER_PAGE, 
"The First " + NUMBER_OF_PRIMES 


" Prime Numbers"); 


tablePrinter.print(primes); 


} 

代码 清单 10-7 RowColumnPagePrinter.java 

package literatePrimes; 

import java.io.PrintStream; 

public class RowColumnPagePrinter { 

private int rowsPerPage; 

private int columnsPerPage; 

private int numbersPerPage; 

private String pageHeader; 

private PrintStream printStream; 

public RowColumnPagePrinter(int rowsPerPage, 

int columnsPerPage, 
String pageHeader) { 

this.rowsPerPage = rowsPerPage; 
this.columnsPerPage = columnsPerPage; 
this.pageHeader = pageHeader; 
numbersPerPage = rowsPerPage * columnsPerPage; 
printStream = System.out; 

} 

public void print(int data[]) { 
int pageNumber = 1; 


for (int firstIndexOnPage = 0; 
firstIndexOnPage < data.length; 
firstIndexOnPage += numbersPerPage) { 
int lastIndexOnPage = 
Math.min(firstIndexOnPage + numbersPerPage - 1, 
data.length - 1); 
printPageHeader(pageHeader, pageNumber); 
printPage(firstIndexOnPage, lastIndexOnPage, data); 
printStream.println("\f"); 


pageNumber++; 


} 
private void printPage(int firstIndexOnPage, 
int lastIndexOnPage, 
int[] data) { 
int firstIndexOfLastRowOnPage = 
firstIndexOnPage + rowsPerPage - 1; 
for (int firstIndexInRow = firstIndexOnPage; 
firstIndexInRow <= firstIndexOfLastRowOnPage; 
firstIndexInRow++) { 
printRow(firstIndexInRow, lastIndexOnPage, data); 


printStream.println(""); 


} 

private void printRow(int firstIndexInRow, 
int lastIndexOnPage, 
int[] data) { 


for (int column = 0; column < columnsPerPage; column++) { 
int index = firstIndexInRow + column * rowsPerPage; 
if (index <= lastIndexOnPage) 
printStream.format("%10d", data[index]); 


} 
private void printPageHeader(String pageHeader, 
int pageNumber) { 
printStream.println(pageHeader + " --- Page " + pageNumber); 
printStream.println(""); 
j 
public void setOutput(PrintStream printStream) 1 


this.printStream - printStream; 


} 
代码 清单 10-8 PrimeGenerator.java 


package literatePrimes; 
import java.util.ArrayList; 
public class PrimeGenerator { 
private static int[] primes; 
private static ArrayList<Integer> multiplesOfPrimeFactors; 
protected static int[] generate(int n) 1 
primes = new int[n]; 
multiplesOfPrimeFactors = new ArrayList<Integer>(); 
set2AsFirstPrime(); 
checkOddNumbersForSubsequentPrimes(); 


return primes; 


} 
private static void set2AsFirstPrime() { 
primes[0] = 2; 
multiplesOfPrimeFactors.add(2); 
} 
private static void checkOddNumbersForSubsequentPrimes() { 
int primeIndex = 1; 
for (int candidate = 3; 
primeIndex < primes.length; 
candidate += 2) { 
if (isPrime(candidate)) 


primes[primeIndex++] = candidate; 


} 
private static boolean isPrime(int candidate) { 
if (isLeastRelevantMultipleOfNextLargerPrimeFactor(candidate)) { 
multiplesOfPrimeFactors.add(candidate); 
return false; 
} 
return isNotMultipleOfAnyPreviousPrimeFactor(candidate); 
} 


private static boolean 
isLeastRelevantMultipleOfNextLargerPrimeFactor(int candidate) { 


int nextLargerPrimeFactor = primes[multiplesOfPrimeFactors.size()]; 
int leastRelevantMultiple = nextLargerPrimeFactor — * 
nextLargerPrimeFactor; 


return candidate == leastRelevantMultiple; 


} 
private static boolean 
isNotMultipleOfAnyPreviousPrimeFactor(int candidate) { 
for (int n = 1; n < multiplesOfPrimeFactors.size(); n++) { 
if (isMultipleOfNthPrimeFactor(candidate, n)) 
retum false; 
} 
return true; 
j 
private static boolean 
isMultipleOfNthPrimeFactor(int candidate, int n) { 
return 
candidate == 
smallestOddNthMultipleNotLessThanCandidate(candidate, n); 
} 
private static int 
smallestOddNthMultipleNotLessThanCandidate(int candidate, int n) 


int multiple = multiplesOfPrimeFactors.get(n); 
while (multiple < candidate) 

multiple += 2 * primes[n]; 
multiplesOfPrimeFactors.set(n, multiple); 


return multiple; 


} 
你 可 能 注意 到 的 第 一 件 事 就 是 程序 比 原 来 长 了 许多 ， 从 1 页 多 增加 
到 了 将 近 3 页 。 这 有 几 个 原因 。 其 一 ， 重 构 后 的 程序 采用 了 更 长 、 更 有 














描述 性 的 变量 名 。 其 二 ， 重 构 后 的 程序 将 函数 和 类 声明 当 作 是 给 代码 添 
加 注释 的 一 种 手段 。 其 三 ， 我 们 采用 了 空格 和 格式 技巧 让 程序 更 可 读 。 

留意 程序 是 如 何 被 拆 分 为 3 个 主要 权 贡 的 。PrimePrinter 类 中 只 有 主 
程序 。 主 程序 的 权 员 是 处 理 执行 环境 。 如 果 调 用 方式 改变 ， 它 也 会 随 之 
改变 。 例 如 ， 如 果 程 序 被 转换 为 SOAP 服 务 ， 则 该 类 也 会 被 影响 到 。 

RowColumnPagePrinter 类 懂得 如 何 将 数字 列表 格式 化 到 有 着 固 定 
行 、 列 数 的 页 面 上 。 知 输出 格式 需要 改动 ， 则 该 类 也 会 被 影响 到 。 

PrimeGenerator 类 懂得 如 何 生成 素数 列表 。 注 意 ， 这 并 不 意味 看 要 
实体 化 为 对 象 。 该 类 就 是 个 有 用 的 作用 域 ， 在 其 中 声明 并 隐藏 变量 。 如 
果 计 算 素 数 的 算法 发 生 改 动 ， 则 该 类 也 会 改动 。 

这 并 不 算是 重 写 ! 我 们 没 从 头 开 始 写 一 志 程 序 。 实 际 上 ， 如 有 果 你 仔 
细 看 上 述 两 个 不 同 的 程序 ， 束 会 发 现 它们 采用 了 同样 的 算法 和 机 制 来 完 
MLE. 

我 们 通过 编写 验证 第 一 个 程序 的 精确 行为 的 用 例 来 实现 修改 。 然 
后 ， 我 们 做 了 许多 小 改动 ， 每 次 改动 一 处 。 每 改动 一 次 ， 就 执行 一 次 ， 
确保 程序 的 行为 没有 变化 。 一 小 步 接 着 一 小 步 ， 第 一 个 程序 被 逐渐 清理 
和 转换 为 第 二 个 程序 。 

















10.3 2 E ZH 2H 

对 于 多 数 系统 ， 修 改 将 一 直 持 续 。 每 处 修改 都 让 我 们 冒 着 系统 其 他 
部 分 不 能 如 期 望 般 工作 的 风险 。 在 整洁 的 系统 中 ， 我 们 对 类 加 以 组 织 ， 
以 降低 修改 的 风险 。 

代码 清单 10-9 中 的 Sql 类 用 来 生成 提供 恰当 元 数据 的 SQL 格式 化 字符 
串 。 这 个 类 还 没 写 完 ， 所 以 暂时 不 支持 update 语 名 等 SQL 功能 。 当 需要 
Sql 类 文 持 update 语 句 时 ， 我 们 就 得 “打开 ”这 个 类 进行 修改 。 打 开 类 市 来 
的 问题 是 风险 随 之 而 来 。 对 类 的 任何 修改 都 有 可 能 破坏 类 中 的 其 他 代 
码 。 必 须 全 面 重 新 测试 。 

代码 清单 10-9 一 个 必须 打开 修改 的 类 

public class Sql { 





public Sql(String table, Column[] columns) 

public String create() 

public String insert(Object[] fields) 

public String selectAll() 

public String findByKey(String keyColumn, String keyValue) 
public String select(Column column, String pattern) 

public String select(Criteria criteria) 

public String preparedInsert() 

private String columnList(Column[] columns) 

private String valuesList(Object[] fields, final Column[] columns) 
private String selectWithCriteria(String criteria) 


private String placeholderList(Column[] columns) 


} 

当 增 加 一 种 新 语句 类 型 时 ， 就 要 修改 。 Sql 类 。 改 动 单个 语句 类 型 
时 ， 也 要 进行 修改 ， 比 如 打算 让 select 功 能 支持 子 查 询 。 存 在 两 个 修改 
的 理由 ， 说 明 Sql 违 反 了 SRP 原 则 。 

可 以 从 一 条 简单 的 组 织 性 观点 发 现 对 “SRP 的 违反 。Sql 的 方法 大 纲 
显示 ， 存 在 类 似 selectWithCriteria 等 只 与 Select 语句 有 关 的 私有 方法 。 

出 现 了 只 与 类 的 一 小 部 分 有 关 的 私有 方法 行为 ， 意 味 着 存在 改进 空 
间 。 然 而 ， 展 开行 动 的 基本 动因 却 应 该 是 系统 的 变动 。 奋 我 们 认为 Sql 
类 在 逻辑 上 已 具足 ， 则 无 需 担心 对 权 责 的 拆 分 。 如 果 在 可 预见 的 未 来 无 
需 增 加 update 功 能 ， 融 该 不 去 动 Sql 类 。 不 过 ， 一 旦 打开 了 类 ， 融 应当 修 
正 设计 方案 。 

代码 清单 10-10 中 的 解决 方式 如 何 呢 ? 代码 清单 10-9 中 Sql 类 的 每 个 
接口 方法 都 重 构 到 从 Sql 类 派生 出 来 的 类 中 了 。 注 意 那 些 私 有 方法 ， 如 
valuesList， 直 接 移 到 了 需要 用 它们 的 地 方 。 公 共 私 有 行为 被 划 分 到 独立 
的 两 个 工具 类 Where 和 ColumnList 中 。 

代码 清单 10-10 一 组 封闭 类 

abstract public class Sql { 























public Sql(String table, Column[] columns) 
abstract public String generate(); 

} 

public class CreateSql extends Sql { 
public CreateSql(String table, Column[] columns) 
@Override public String generate() 

} 

public class SelectSql extends Sql { 
public SelectSql(String table, Column[] columns) 
@Override public String generate() 


} 
public class InsertSql extends Sql { 
public InsertSql(String table, Column[] columns, Object[] fields) 
@Override public String generate() 
private String valuesList(Object[] fields, final Column[] columns) 
j 
public class SelectWithCriteriaSql extends Sql { 
public SelectWithCriteriaSql( 
String table, Column[] columns, Criteria criteria) 
@Override public String generate() 
j 
public class SelectWithMatchSgl extends Sql { 
public SelectWithMatchSql( 
String table, Column[] columns, Column column, String pattern) 
@Override public String generate() 
j 
public class FindByKeySgl extends Sql{ 
public FindByKeySql( 
String table, Column[] columns, String keyColumn, String 
key Value) 
@Override public String generate() 
j 
public class PreparedInsertSql extends Sql 1 
public PreparedInsertSql(String table, Column[] columns) 
@Override public String generate(){ 


private String placeholderList(Column[] columns) 


public class Where { 
public Where(String criteria) 
public String generate() 
} 
public class ColumnList { 
public ColumnList(Column[] columns) 
public String generate() 

} 

每 个 类 中 的 代码 都 变 得 极为 简单 。 理 解 每 个 类 花费 的 时 间 缩 减 到 近 
乎 为 零 。 函 数 对 其 他 函数 造成 毁坏 的 风险 也 变 得 几 近 于 无 。 从 测试 的 角 
度 看 ， 验 证 方案 中 每 一 处 逻辑 都 成 了 极为 简单 的 任务 ， 因 为 类 与 类 之 间 
相互 隔离 了 。 

当 需 要 增加 update 语 句 时 ， 现 存 类 无 需 做 任何 修改 ， 这 也 同等 重 
要 ! 我 们 在 Sql 类 的 新 子 类 UpdateSql 中 构建 update 语 句 的 逻辑 。 系 统 中 
的 其 他 代码 都 不 会 因为 这 个 修改 而 被 破坏 。 

重新 架构 的 Sql 逻辑 百 利 而 无 一 浆 。 它 支持 SRP。 它 也 支持 其 他 面向 
对 象 设 计 的 关键 原则 ， 如 开放 -闭合 原则 COCPO [4]: 类 应 当 对 扩展 开 
放 ， 对 修改 封闭 。 通 过 子 类 化 手段 ， 重 新 染 构 的 Sql 类 对 添加 新 功能 是 
开放 的 ， 而 且 可 以 同时 不 触及 其 他 类 。 只 要 将 UpdateSql 类 放置 到 位 就 
AT d. 
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子 。 在 理想 系统 中 ， 我 们 通过 扩展 系统 而 非 修改 现 有 代码 来 添加 新 特 
性 。 

隔离 修改 

需求 会 改变 ， 所 以 代码 也 会 改变 。 在 OO ”101[5] 中 ， 我 们 学 习 到 ， 
具体 类 包含 实现 细节 《代码 ) ， 而 抽象 类 则 只 呈现 概念 。 依 赖 于 具体 细 
市 的 客户 类 ， 当 细 市 改变 时 ， 束 会 有 风险 。 我 们 可 以 借助 接口 和 抽象 类 























来 隔离 这 些 细 市 带 来 的 影响 。 

对 具体 细节 的 依赖 给 对 系统 的 测试 带 来 了 挑战 。 如 果 我 们 构建 一 个 
依赖 于 外 部 TokyoStockExchange API 的 Portfolio 类 ， 代 表 投 资 组 合 的 价 
值 ， 则 测试 用 例 就 会 受到 价值 查询 的 连 市 影响。 如 果 每 5 分 钟 靳 有 新 说 
法 ， 就 很 难 写 出 测试 来 。 

与 其 设计 直接 依赖 于 TokyoStockExchange 的 Portfolio 类 ， 不 如 创建 
StockExchange 接 口 ， 其 中 只 声明 一 个 方法 : 

public interface StockExchange { 

Money currentPrice(String symbol); 

} 

我 们 设计 TokyoStockExchange 类 来 实现 这 个 接口 。 我 们 还 要 确保 
Portfolio 的 构造 器 接受 作为 参数 的 StockExchange 引 用 : 

public Portfolio { 

private StockExchange exchange; 
public Portfolio(StockExchange exchange) { 


this.exchange = exchange; 


Mis 
} 
现在 就 可 以 为 StockExchange 接口 创建 可 测试 的 笃 试 性 实现 了 。 该 
莹 试 性 实现 将 返回 固定 的 现 值 。 如 果 测 试 中 购买 了 5 股 微软 股票 ， 则 和 按 
试 性 实现 总 是 返回 每 股 100 美 元 的 现 值 。 对 于 StockExchange 接口 的 答 
试 性 实现 简化 为 简单 的 表格 和 查找。 然后 再 编号 一 个 总 投资 价值 为 500 美 
元 的 测试 。 


public class PortfolioTest { 





private FixedStockExchangeStub exchange; 


private Portfolio portfolio; 


@Before 

protected void setUp() throws Exception { 
exchange = new FixedStockExchangeStub(); 
exchange.fix("MSFT", 100); 
portfolio = new Portfolio(exchange); 

} 

@Test 

public void GivenFiveMSFTTotalShouldBe500() throws Exception { 
portfolio.add(5, "MSFT"); 
Assert.assertEquals(500, portfolio.value()); 


} 

WR BAAS BE WPA EE, BRER, Ela 
Ho FAP ZT AR Nee ARAN sos SOR. BEI HE 
系统 每 个 元 素 的 理解 变 得 更 加 容易 。 

通过 降低 连接 度 ， 我 们 的 类 就 遵循 了 男 一 条 类 设计 原则 ， 依 赖 倒置 
JÆ] (Dependency Inversion Principle，DIP〉[6]。 本 质 而 言 ，DIP 认 为 
类 应 当 依 赖 于 抽象 而 不 是 依赖 于 有 具体 细节 。 

我 们 的 Portfolio 类 不 再 依赖 于 TokyoStockExchange 类 的 实现 细节 ， 
而 是 依赖 于 StockExchange 接 口 。StockExchange 接 口 呈 现 的 是 有 关 询 问 
某 只 股票 价格 的 抽象 概念 。 这 种 抽象 隔离 了 所 有 询 价 的 特定 细节 ， 包 括 
价格 数据 来 自 何 处 之 类 。 
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11.1 如 何 建造 一 个 城市 





你 能 上 自己 掌管 一 切 细节 吗 ? 大 概 不 行 。 即 便 是 管理 一 个 既 存 的 城 
市 ， 也 是 一 个 人 无 法 做 到 的 。 不 过 ， 城 市 还 是 在 运转 (多 数 时 候 ) 。 因 
为 每 个 城市 都 有 一 组 组 人 管理 不 同 的 部 分 ， 供 水 系统 、 供 电 系 统 、 交 
通 、 执 法 、 立 法 ， 诸 如 此 类 。 有 些 人 人 负 员 全 局 ， 其 他 人 负责 细 市 。 

城市 能 运转 ， 还 因为 它 演 化 出 恰当 的 抽象 等 级 和 模块 ， 好 让 个 人 和 
他 们 所 管理 的 “组 件 ? 即 便 在 不 了 解 全 局 时 也 能 有 效 地 运转 。 

尽管 软件 团队 往往 也 是 这 样 组 织 起 来 ， 但 他 们 所 致力 的 工作 却 币 过 
没有 同样 的 关注 面 切 分 及 抽象 层级 。 整 洁 的 代码 帮助 我 们 在 较 低层 的 抽 
象 层级 上 达成 这 一 目标 。 本 章 将 讨论 如 何在 较 高 的 抽象 层级 一 一 系统 层 
级 一 一 上 保持 整洁 。 





11.2 K AZ Mie E ay 


首先 ， 构 造 与 使 用 是 非常 不 一 样 的 过 程 。 当 我 走笔 全 此 ， 投 目 窗外 
的 芝加哥 ， 看 到 有 一 间 酒 店 正 在 建设 。 今 天 ， 那 只 是 个 框架 结构 ， 起 重 
机 和 升降 机 附着 在 外 和 面 。 和 忙碌 的 人 们 号 军工 作 服 ， 尖 戴 安 全 帽 。 大 概 一 
年 之 后 ， 酒 店 就 将 建成 。 起 重 机 和 升降 机 都 会 消失 无 踪 。 建 筑 物 变 得 整 
洁 ， 履 盖 着 玻璃 幕墙 和 漂亮 的 潜 色 。 在 其 中 工作 和 住宿 的 人 ， 会 看 到 完 
全 不 同 的 景象 。 

软件 系统 应 将 局 始 过 程 和 局 始 过 程 之 后 的 运行 时 逻辑 分 离开 ， 在 局 
台 过 程 中 构建 应 用 对 象 ， 也 会 存在 互相 缠 结 的 依赖 关系 。 

每 个 应 用 程序 都 该 留意 启 始 过 程 。 那 也 是 本 章 中 我 们 首先 要 考虑 的 
问题 。 将 关注 的 方面 分 离开 ， 是 软件 技艺 中 最 古老 也 最 重要 的 设计 技 
Pj. 

不 幸 的 是 ， 多 数 应 用 程序 都 没有 做 分 离 处 理 。 司 始 过 程 代码 很 特 
殊 ， 被 混杂 到 运行 时 逻辑 中 。 下 例 就 是 典型 的 情形 : 


public Service getService() { 

















if (service == null) 
service = new MyServiceImpl(...); // Good enough default for most 
cases? 
return service; 
} 
这 就 是 所 谓 延 迟 初始 化 /赋值 ， 也 有 一 些 好 处 。 在 真正 用 到 对 象 之 
， 无 需 操心 这 种 架空 构造 ， 启 始 时 间 也 会 更 短 ， 而 且 还 能 保证 永远 不 
返回 null 值 。 








ak 


然而 ， 我 们 也 得 到 了 MyServicelmpl 及 其 构造 器 所 需 一 切 “〈 我 省 略 
了 那些 代码 ) 的 硬 编码 依赖 。 不 分 解 这 些 依赖 关系 就 无 法 编译 ， 即 便 在 
运行 时 永 不 使 用 这 种 类 型 的 对 象 ! 

如 果 MyServiceImpl 古 个 重型 对 象 ， 则 测试 也 会 是 个 问题 。 我 们 必 
须 确保 在 单元 测试 调用 该 方法 之 前 ， 就 给 service 指派 恰当 的 测试 蔡 号 
(TEST DOUBLE) [1 或 仿制 对 象 (MOCK OBJECTO 。 由 于 构造 逻辑 
与 运行 过 程 相 混杂 ， 我 们 必须 测试 所 有 的 执行 路 径 《〈 例 如 ，null 值 测试 
及 其 代码 块 )。 有 了 这 些 权贵 ， 说 明 方 法 做 了 不 止 一 件 事 ， 这 样 就 略微 
违反 了 单一 权 员 原则 。 

最 糟糕 的 大 概 是 我 们 不 知道 MyServiceImpl 在 所 有 情形 中 是 否 都 是 
正确 的 对 象 。 我 在 代码 注释 中 做 了 暗示。 为 什么 该 方法 所 属 类 必须 知道 
全 局 情景 ? 我 们 是 否 真能 知道 在 这 里 要 用 到 的 正确 对 象 ? 是 否 真 有 可 能 
存在 一 种 放 之 四 海 而 丝 准 的 类 型 ? 

当然 ， 仅 出 现 一 次 的 延迟 初始 化 不 算是 严重 问题 。 不 过 ， 在 应 用 程 
序 中 往往 有 许多 种 类 似 的 情况 出 现 。 于 是 ， 全 局 设置 策略 (如 果 有 的 
Th) 在 应 用 程序 中 四 散 分 布 ， 缺 乏 模 块 组 织 性 ， 通 党 也 会 有 许多 重复 代 
人 码 。 

如 果 我 们 勤 于 打造 有 着 民 好 格式 并 且 强 固 的 系统 ， 就 不 该 让 这 类 就 
手 小 技巧 破坏 模块 组 织 性 。 对 象 构造 的 局 始 和 设置 过 程 也 不 例外 。 应 当 
将 这 个 过 程 从 正常 的 运行 时 逻辑 中 分 离 出 来 ， 确 保 拥 有 人 解决 主要 依赖 问 
题 的 全 局 性 一 贯 策略 。 























11.2.1 7j fi main 


Tei 5 f HH ATAEHJZT AZ. AME RETE UT Bll main BY CER 
之 为 main 的 模块 中 ， 设 计 系 统 的 其 余部 分 时 ， 假 设 所 有 对 象 都 已 正确 构 
造 和 设置 〈 如 图 11-1 所 示 ) 。 


控制 流程 很 容易 理解 。main 函 数 创建 系统 所 需 的 对 象 ， 再 传递 给 应 
用 程序 ， 应 用 程序 只 管 使 用 。 注 意 看 横贯 main 与 应 用 程序 之 间隔 篇 的 依 
赖 箭头 的 方向 。 它 们 都 从 main 函 数 向 外 走 。 这 表示 应 用 程序 对 main 或 者 
构造 过 程 一 无 所 知 。 它 只 是 简单 地 指望 一 切 已 齐备 。 


application 


^ 
. 


co:Configured 
Object 


- 





图 11-1 将 构造 分 解 到 main( ) 中 
11.2.2 L) 


当然 ， 有 时 应 用 程序 也 要 负责 确定 何 时 创建 对 象 。 比 如 ， 在 某 个 订 
单 处 理 系统 中 ， 应 用 程序 必须 创建 LineItem 实 体 ， 添 加 到 Order 对 象 。 在 
这 种 情况 下 ， 我 们 可 以 使 用 抽象 工厂 模式 [2] 计 应 用 自行 控制 何 时 创建 
LineItems， 但 构造 的 细节 却 隔离 于 应 用 程序 代码 之 外 。 






run (factory ) 


OrderProcessing 
<<creates>> 
T inefiemFE <<interiace>> 
CEE AIT Di LineltemFactory 
Implementation - 
+makeLineltem 


<<creates>> 














图 11-2 使 用 工厂 分 离 构造 过 程 


再 留意 一 下 ， 所 有 依赖 都 是 从 main 指 问 OrderProcessing 应 用 程序 。 
这 代表 应 用 程序 与 如 何 构建 LineItem 的 细节 是 分 离开 来 的 。 构 建 能 力 由 
LineItemFactoryImplementation 持 有 ， 而 LineItemFactoryImplementation 又 
是 在 main 这 一 边 的 。 但 应 用 程序 能 完全 控制 Lineltem 实 体 何 时 构建 ， 甚 
至 能 传递 应 用 特定 的 构造 器 参数 。 





11.2.3 依赖 注 


有 一 种 强大 的 机 制 可 以 实现 分 离 构造 与 使 用 ， 那 就 是 依赖 注入 

(Dependency Injection, DI) ize (Inversion of Control, IoC) 
在 依赖 管理 中 的 一 种 应 用 手段 B]。 控 制 反 转 将 第 二 权 贡 从 对 象 中 拿 出 
来 ， 转 移 到 另 一 个 专注 于 此 的 对 象 中 ， 从 而 遵循 了 单一 权 责 原则 。 在 依 
赖 管理 情景 中 ， 对 象 不 应 负责 实体 化 对 上 自 喘 的 依赖 。 反 之 ， 它 应 当 将 这 
份 权 责 移交 给 其 他 “有 权力 ”的 机 制 ， 从 而 实现 控制 的 反 转 。 因 为 初始 设 
置 是 一 种 全 局 问题 ， 这 种 授权 机 制 通常 要 么 是 main 例 程 ， 要 么 是 有 特定 
目的 的 容器 。 


JNDI 查 找 是 DI 的 一 种 “部 分 ”实现 。 在 JNDI 中 ， 对 象 请 求 目 录 服 务 
器 提供 一 种 符合 某 个 特定 名 称 的 “服务 ”。 


MyService myService = (MyService) 





(jndiContext.lookup("NameOfMyService")); 

调用 对 象 并 不 控制 真正 返回 对 象 的 类 别 〈 当 然 前 提 是 它 实现 了 恰当 
的 接口 ) ， 但 调用 对 象 仍然 主动 分 解 了 依赖 。 

真正 的 依赖 注入 还 要 更 进一步 。 类 并 不 直接 分 解 其 依赖 ， 而 是 完 
被 动 的 。 它 提供 可 用 于 注入 依赖 的 赋值 右 方 法 或 构造 句 参 数 〈 或 二 者 络 
A) 。 在 构造 过 程 中 ，DI 容器 实体 化 需要 的 对 象 “通常 按 需 创建 ) ， 
并 使 用 构造 器 参数 或 赋值 器 方法 将 依赖 连接 到 一 起 。 至 于 哪个 依赖 对 象 
真正 得 到 使 用 ， 是 通过 配置 文件 或 在 一 个 有 特殊 目的 的 构造 模块 中 编程 
决定 。 

Spring 框架 提供 了 最 有 名 的 Java DI 容 器 [4]。 用 户 在 XML 配置 文件 中 
定义 互相 关联 的 对 象 ， 然 后 用 Java 代 码 请 求 特 定 的 对 象 。 稍 后 我 们 就 会 
看 到 例子 。 

但 延 后 初始 化 的 好 处 是 什么 呢 ? 这 种 手段 在 DI 中 也 有 其 作用 。 首 
先 ， 多 数 DI 容器 在 需要 对 象 之 前 并 不 构造 对 象 。 其 次 ， 许 多 这 类 容器 提 
供 调用 工厂 或 构造 代理 的 机 制 ， 而 这 种 机 制 可 为 延迟 赋值 或 类 似 的 优化 
处 理 所 用 [5]。 











11.3 扩容 


AJ rH AREA, RAT .. 一 开始 ， 道 路 狭窄， is^. 
涉足 ， 随 后 逐渐 拓宽 。 小 型 建筑 和 空地 渐渐 被 更 大 的 建筑 所 取代 ， 
地 方 最 终 音 立 起 摩天 大 楼 。 

一 开始 ， 供 电 、 供 水 、 下 水 、 互 联网 ( 哇 ! ) 等 服务 全 部 欠 奉 。 随 
着 人 口 和 建筑 密度 的 增加 ， 这 些 服务 也 开始 出 现 。 

这 种 成 长 并 非 全 无 阵痛 。 你 有 多 少 次 开 着 车 ， 艰 难 罕 行 过 一 个 “ 道 
路 改善 ?工程 ， 问 自己, “他 们 为 什么 不 一 开始 就 修 条 够 宽 的 路 昵 ? ! ” 

不 过 那 无 论 如 何不 可 能 实现 。 eG eT 条 六 
车 道 的 公路 并 不 浪费 呢 ?” 谁 会 想 要 这 么 一 条 罕 过 他 们 小 镇 的 路 呢 ? 

“一 开始 就 做 对 系统 ” 纯 属 神话 。 反 之 ， 我 们 应 该 只 去 实现 今天 的 用 
户 故 事 ， 然 后 重 构 ， 明 天 再 扩展 系统 、 实 现 新 的 用 户 故 事 。 这 就 是 迭代 
和 增 量 敏捷 的 精髓 所 在 。 测 试 驱动 开发 、 重 构 以 及 它们 打造 出 的 整洁 代 
人 码 ， 在 代码 层 面 保证 了 这 个 过 程 的 实现 。 

但 在 系统 层面 又 如 何 ? 难道 系统 架构 不 需要 预先 做 好 计划 吗 ? 系统 
理所当然 不 可 能 从 简单 递增 到 复杂 ， 它 能 行 吗 ? 

软件 系统 与 物理 系统 可 以 类 比 。 它 们 的 架构 都 可 以 递增 式 地 增长 ， 
只 要 我 们 持续 将 关注 面 恰当 地 切 分 。 

如 我 们 将 见 到 的 那样 ， 软 件 系 统 短 生 命 周 期 本 质 使 这 一 切 变 得 可 

。 我 们 先 来 看 一 个 没有 充分 隔离 关注 问题 的 架构 反例 。 

初始 的 EJB1 和 EJB2 架 构 没有 恰当 地 切 分 关注 面 ， 从 而 给 有 机 增长 
压 上 了 不 必要 的 负担 。 比 如 一 个 持久 Bank 类 的 Entity Bean. Entity bean 
是 关系 数据 在 内 存 中 的 体现 ， 换 言 之 ， 是 表格 的 一 行 











首先 ， 你 要 定义 一 个 本 地 《进程 内 ) 或 远程 (分 离 的 JVM) 接口 ， 
供 客户 代码 使 用 。 代 人 码 清单 11-1 束 是 一 种 可 能 的 本 地 接口 : 
代码 清单 11-1 Bank EJB 的 EJB2 本 地 接口 
package com.example.banking; 
import java.util.Collections; 
import javax.ejb.*; 
public interface BankLocal extends java.ejb.EJBLocalObject { 
String getStreetAddr1() throws EJBException; 
String getStreetAddr2() throws EJBException; 
String getCity() throws EJBException; 
String getState() throws EJBException; 
String getZipCode() throws EJBException; 
void setStreetAddr1(String street1) throws EJBException; 
void setStreetAddr2(String street2) throws EJBException; 
void setCity(String city) throws EJBException; 
void setState(String state) throws EJBException; 
void setZipCode(String zip) throws EJBException; 
Collection getAccounts() throws EJBException; 
void setAccounts(Collection accounts) throws EJBException; 
void addAccount(AccountDTO accountDTO) throws EJBException; 
} 
上 面 列 出 了 银行 地 址 的 几 个 属性 ， 和 一 组 该 银行 拥有 的 账 尸 ， 其 中 
每 个 账户 的 数据 都 由 单独 的 Account ”EJB 所持 有 。 代 码 清 单 11-2 展 示 了 
Bank bean 的 相应 实现 类 。 
代码 清单 11-2 相应 的 EJB2 Entity Bean 实 现 
package com.example.banking; 


import java.util.Collections; 


import javax.ejb.*; 
public abstract class Bank implements javax.ejb.EntityBean { 
/业务 逻辑 .… 
public abstract String getStreetAddr1(); 
public abstract String getStreetAddr2(); 
public abstract String getCity(); 
public abstract String getState(); 
public abstract String getZipCode(); 
public abstract void setStreetAddr1(String street1); 
public abstract void setStreetAddr2(String street2); 
public abstract void setCity(String city); 
public abstract void setState(String state); 
public abstract void setZipCode(String zip); 
public abstract Collection getAccounts(); 
public abstract void setAccounts(Collection accounts); 
public void addAccount(AccountDTO accountDTO) { 
InitialContext context = new InitialContext(); 
AccountHomeLocal accountHome 
context.lookup("AccountHomeLocal"); 
AccountLocal account = accountHome.create(accountDTO); 
Collection accounts = getAccounts(); 
accounts.add(account); 
} 
// EJB container logic 
public abstract void setId(Integer id); 
public abstract Integer getId(); 
public Integer ejbCreate(Integer id) { ... } 


public void ejbPostCreate(Integer id) { ... } 

// The rest had to be implemented but were usually empty: 
public void setEntityContext(EntityContext ctx) {} 

public void unsetEntityContext() {} 

public void ejbActivate() { } 

public void ejbPassivate() {} 

public void ejbLoad() { } 

public void ejbStore() { } 

public void ejbRemove() { } 

} 

我 没有 列 出 对 应 的 LocalHome 接 口 ， 该 接口 基本 上 是 用 来 创建 对 象 
的 ， 也 没有 列 出 你 可 能 添加 的 Bank 但 找 絮 (但 询 )。 

最 后 ， 你 要 编写 一 个 或 多 个 XML 部 署 说 明 ， 将 对 象 相关 映射 细节 
旨 定 给 某 个 持久 化 存储 空间 ， 说 明 期 望 的 事物 行为 、 安 全 约束 等 。 

业务 逻辑 与 EJB2 应 用 “容器 ”紧密 粳 合 。 你 必须 子 类 化 容 絮 类 型 ， 
必须 提供 许多 个 该 容 强 所 圾 要 的 生命 周期 方法 。 

由 于 存在 这 种 与 重量 级 容器 的 紧 厢 合 ， 隔 离 蛙 元 测试 就 很 困难 。 有 
必要 模拟 出 容器 (这 很 难 ) ， 或 者 花费 大 量 时 间 在 真实 服务 器 上 部 加 
EJB 和 测试 。 也 由 于 耦合 的 存在 ， 在 EJB2 架 构 之 外 的 复 用 实际 上 变 得 不 
可 能 。 

最 终 ， 连 面向 对 象 编程 本 映 也 被 侵蚀 。bean 不 能 继承 上 自 男 一 个 
bean。 留 意 添加 新 账号 的 迎 辑 。 在 EJB2 bean 中 ， 定 义 一 种 本 质 上 是 无 行 
为 struct 的 “数据 传输 对 象 ” (DTO) 很 常见 。 这 往往 会 导致 拥有 同样 数据 
的 元 余 类 型 出 现 ， 而 且 也 需要 在 对 象 之 间 复 制 数据 的 八股 式 代 码 。 

横贯 式 关 注 面 

在 某 些 领域 ，EBJ2 架 构 已 经 很 接近 于 真正 的 关注 面 切 分 。 例 如 ， 在 
与 源 代 码 分 离 的 部 普 描 述 中 声明 了 期 竺 的 事务 、 安 全 及 部 分 持久 化 行 
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会 想 用 同样 的 策略 来 持久 化 所 有 对 象 ， 例 如 ， 使 用 DBMS[6] 而 非 平面 文 
件 ， 表 名 和 列 名 遵循 某 种 命名 约定 ， 采 用 一 致 的 事务 语义 ， 等 等 。 

原则 上 ， 你 可 以 从 模块 、 封 装 的 角度 推理 持久 化 策略 。 但 在 实践 
上 ， 你 却 不 得 不 将 实现 了 持久 化 策略 的 代码 铺展 到 许多 对 象 中 。 我 们 用 
术语 “横贯 式 关注 面 " 来 形容 这 类 情况 。 同 样 ， 持 久 化 框架 和 领域 逻辑 ， 
孤立 地 看 也 可 以 是 模块 化 的 。 问 题 在 于 横 吐 这 些 领域 的 情形 。 

实际 上 ，EJB 架 构 处 理 持久 化 、 安 全 和 事务 的 方法 是 “预期 * 面 同方 
面 编 程 (aspect-oriented programming, AOP) [Z]， 而 AOP 是 一 种 恢复 横 
贯 式 关 注 面 模块 化 的 普 适 手段 。 

在 AOP 中 ， 被 称 为 方面 (aspect〉 的 模块 构造 指明 了 系统 中 哪些 点 
的 行为 会 以 某 种 一 致 的 方式 被 修改 ， 从 而 文 持 某 种 特定 的 场景 。 这 种 说 
明 是 用 茶 种 简洁 的 声明 或 编程 机 制 来 实现 的 。 

以 持久 化 为 例 ， 可 以 声明 哪些 对 象 和 属性 (或 其 模式 ) 应 当 被 持久 
化 ， 然 后 将 持久 化 任务 委托 给 持久 化 框架 。 行 为 的 修改 由 ”AOP 框 架 以 
无 损 方式 [8] 在 目标 代码 中 进行 。 下 面 来 看 看 Java 中 的 三 种 方面 或 类 似 方 
面 的 机 制 。 








11.4 Java 代 理 


Java 代 理 适 用 于 简单 的 情况 ， 例 如 在 单独 的 对 象 或 类 中 包装 方法 调 
用 。 然 而 ，JDK 提 供 的 动态 代理 仅 能 与 接口 协同 工作 。 对 于 代理 类 ， 你 
得 使 用 字 节 码 操作 库 ， 比 如 CGLIB、ASM 或 Javassist[9]。 
代码 清单 11-3 展 示 了 为 我 们 的 Bank 应 用 程序 提供 持久 化 支持 的 JDK 
代理 ， 代 码 仅 覆盖 设置 和 取得 账号 列表 的 方法 。 
代码 清单 11-3 JDK 代 理 范例 
// Bank.java (suppressing package names...) 
import java.utils.*; 
// The abstraction of a bank. 
public interface Bank { 
Collection<Account> getAccounts(); 
void setAccounts(Collection<Account> accounts); 
} 
// BankImpl.java 
import java.utils.*; 
// The "Plain Old Java Object" (POJO) implementing the abstraction. 
public class BankImpl implements Bank { 
private List<Account> accounts; 
public Collection<Account> getAccounts() { 
return accounts; 
j 


public void setAccounts(Collection<Account> accounts) 1 


this.accounts = new ArrayList<Account>(); 
for (Account account: accounts) { 


this.accounts.add(account); 


} 
// BankProxyHandler.java 
import java.lang.reflect.*; 
import java.util.*; 
// "InvocationHandler" required by the proxy API. 
public class BankProxyHandler implements InvocationHandler { 
private Bank bank; 
public BankHandler (Bank bank) { 
this.bank = bank; 
} 
// Method defined in InvocationHandler 
public Object invoke(Object proxy, Method method, Object[] args) 
throws Throwable { 

String methodName = method.getName(); 

if (methodName.equals("getA ccounts")) { 
bank.setAccounts(getAccountsFromDatabase()); 
return bank.getAccounts(); 

} else if (methodName.equals("setAccounts")) { 
bank.setAccounts((Collection<Account>) args[0]); 
setAccountsToDatabase(bank.getA ccounts()); 
return null; 

} else { 


} 
// Lots of details here: 
protected Collection<Account> getAccountsFromDatabase() { ... } 
protected void setAccountsToDatabase(Collection<Account> 
accounts) { ... } 
} 
// Somewhere else... 
Bank bank = (Bank) Proxy.newProxyInstance( 
Bank.class.getClassLoader(), 
new Class[] { Bank.class }, 
new BankProxyHandler(new BankImpl())); 
我 们 定义 了 将 被 代理 包装 起 来 的 接口 Bank， 还 有 旧式 的 Java 对 象 
(Plain-Old Java Object, POJO) BankImpl， 该 对 象 实现 业务 逻辑 Cj 
后 再 来 看 POJO) > 
Proxy API 需要 一 个 InvocationHandler 对 象 ， 用 来 实现 对 代理 的 全 
部 Bank 方法 调用 。BankProxyHandler 使 用 Java 反 射 API 将 一 般 方法 调用 
映射 到 BankImpl 中 的 对 应 方法 ， 以 此 类 推 。 
即便 对 于 这 样 简 单 的 例子 ， 也 有 许多 相对 复杂 的 代码 [10]。 使 用 那 
些 字 节操 作 类 库 也 同样 具有 挑战 性 。 代 码 量 和 复杂 度 是 代理 的 两 大 弱 
扩 ， 创 建 整 洁 代 码 变 得 很 难 ! 态 外 ， 代 理 也 没有 提供 在 系统 范围 内 指定 
执行 点 的 机 制 ， 而 那 正 是 真正 的 AOP 解 决 方案 所 必须 的 11]。 
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幸运 的 是 ， 编 程 工具 能 自动 处 理 大 多 数 代 理 模板 代码 。 在 数 个 Java 
框架 中 ， 代 理 都 是 内 骨 的 ， 如 Spring AOP 和 JBoss AOP 等 ， 从 而 能 够 以 
纯 Java 代 码 实 现 面 辐 方 面 编程 [L2]。 在 Spring 中 ， 你 将 业务 逻辑 编码 为 旧 
式 Java 对 象 。POJO 目 扫 门 前 雪 ， 并 不 依赖 于 企业 框架 《或 其 他 域 ) 。 
此 ， 它 在 概念 上 更 简单 、 更 易于 测试 驱动 。 相 对 简单 性 也 较 易 于 保证 正 
确 地 实现 相应 的 用 户 故 事 ， 并 为 未 来 的 用 户 故 事 维 护 和 改进 代码 。 

使 用 摘 述 性 配置 文件 或 API， 你 把 需要 的 应 用 程序 构架 组 合 起 来 ， 
包括 持久 化 、 事 务 、 安 人 全、 缓存 、 恢 复 等 横贯 性 问题 。 在 许多 情况 下 ， 
你 实际 上 只 是 指定 Spring 或 Jboss 类 库 ， 框 架 以 对 用 户 透明 的 方式 处 理 使 
用 Java 代 理 或 字 节 代码 库 的 机 制 。 这 些 声 明了 驱动 了 依赖 注入 (DI) # 
器 ，DI 容 器 再 实体 化 主要 对 象 ， 并 按 需 将 对 象 连 接 起 来 。 

代码 清单 11-4 展 示 了 Spring V2.5 配 置 文件 app.xml 的 典型 片段 [13]。 

代码 清单 11-4 Spring 2.x 的 配置 文件 


<beans> 




















<bean id="appDataSource" 
class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:driverClassName="com.mysql.jdbc.Driver" 
p:url="jdbc:mysql://localhost:3306/mydb" 
p:username="me"/> 


<bean id="bankDataAccessObject" 


class="com.example.banking.persistence.BankDataAccessObject 
p:dataSource-ref="appDataSource"/> 

<bean id="bank" 

class="com.example.banking.model.Bank" 


p:dataAccessObject-ref="bankDataAccessObject"/> 


</beans> 

f^ bean (Rt REE MELE” Pt, RHEIN 
Z (DAO) 代理 (包装 ) 的 Bank 都 有 个 域 对 象 ， 而 bean 本 身 又 是 由 
JDBC 了 驱动 程序 数据 源 代理 (如 图 11-3 所 示 ) è 


AppDataSource 


客户 代码 


图 11-3“ 俄 罗斯 套 娃 ” 式 的 油漆 工 模式 
































客户 代码 以 为 调用 的 是 Bank 对 象 的 getAccount( ) 方 法 ， 其 实 它 是 在 
与 一 组 扩展 Bank POJO 基 础 行为 的 油漆 工 (DECORATOR) [14p6] & re 
最 外 面 的 那个 沟通 。 

在 应 用 程序 中 ， 只 添加 了 少数 几 行 代码 ， 用 来 名 DI 容器 请 求 系统 中 
的 顶层 对 象 ， 如 XML 文 件 中 所 定义 的 那样 。 


XmlBeanFactory bf = 
new XmlBeanFactory(new ClassPathResource("app.xml", 
getClass())); 


Bank bank = (Bank) bf.getBean("bank"); 





只 有 区 区 几 行 与 Spring 相 关 的 Java 代 码 ， 应 用 程序 几乎 完全 与 Spring 
分 离 ， 消 除了 EJB2 之 类 系统 中 那 种 紧 耘 合 问题 。 

尽管 XML 可 能 会 元 长 且 难 以 阅读 [51， 配 置 文件 中 定义 的 “策略 ”还 
是 要 比 那 种 隐藏 在 妖 后 自动 创建 的 复杂 的 代理 和 方面 逻辑 来 得 简单 。 这 
种 类 型 的 架构 是 如 此 引 人 注 目 ，Spring 之 类 的 框架 最 终 导致 了 EJB 标准 
在 第 3 版 的 彻底 变化 。 使 用 XML 配置 文件 和 /或 Java 5 annotation, EJB3 
很 大 程度 上 遵循 了 Spring 通过 摘 述 性 手段 文 持 横 贯 式 关 注 面 的 模型 。 

代码 清单 11-5 展 示 了 用 EJB3 重 写 的 Bank 对 象 [16]。 

代码 清单 11-5 EJB3 版 本 的 Bank 


package com.example.banking.model; 








import javax.persistence.*; 
import java.util.ArrayList; 
import java.util.Collection; 
@Entity 
@Table(name = "BANKS") 
public class Bank implements java.io.Serializable { 
@Id @GeneratedValue(strategy=GenerationType.AUTO) 
private int id; 
@Embeddable // An object "inlined" in Bank’s DB row 
public class Address { 
protected String streetAddr1; 
protected String streetAddr2; 
protected String city; 
protected String state; 
protected String zipCode; 
} 
@Embedded 


private Address address; 
@OneToMany(cascade = CascadeType.ALL, fetch = 
FetchType.EAGER, 
mappedBy="bank") 

private Collection<Account> accounts = new ArrayList<Account>(); 
public int getId() 1 

return id; 
} 
public void setId(int id) { 

this.id = id; 
} 
public void addAccount(Account account) { 

account.setBank(this); 

accounts.add(account); 
} 
public Collection<Account> getAccounts() { 

return accounts; 
} 
public void setAccounts(Collection<Account> accounts) { 


this.accounts = accounts; 


} 

上 列 代 码 要 比 原 本 的 EJB2 人 代码 整洁 多 了 。 有 些 实体 细节 仍然 在 
annotation 中 存在 。 不 过 ， 因 为 没有 任何 信息 超出 annotation 之 外 ， 代 码 
依然 整洁 、 清 晰 ， 也 因此 而 易于 测试 驱动 、 易 于 维护 。 

如 果 愿 意 的 话 ，annotation 中 有 些 或 全 部 持久 化 信息 可 以 转移 到 
XML 部 署 描述 中 ， 只 留 下 真正 的 纯 POJO。 如 果 持 久 化 映射 细节 不 会 频 


繁 改动 ， 许 多 团队 可 能 会 选择 保留 annotation， 但 与 EJB2 那 种 侵害 性 相 


比 还 是 少 了 很 多 问题 。 





11.6 AspectJ 的 方面 


通过 方面 来 实现 关注 面 切 分 的 功能 最 全 的 工具 是 AspectJ 语 言 [17]， 
一 种 提供 “一 流 的 ?将 方面 作为 模块 构造 处 理 文 持 的 Java 扩 展 。 在 
80%~90% 用 到 方面 特性 的 情况 下 ，Spring AOP 和 JBoss AOP 提 供 的 纯 
Java 实 现 手段 足够 使 用 。 人 然而 ，AspectJ 却 提供 了 一 套用 以 切 分 关注 面 的 
丰富 而 强 有 力 的 工具 。AspectJ 的 弱势 在 于 ， 需 要 玉 用 几 种 新 工具 ， 学 习 
新 语言 构造 和 使 用 方式 。 

# HH AspectJ #43] AM *annotation form”( 使 用 Java 5 annotation 定 
义 纯 Java 代 码 的 方面 ) ， 新 工具 采用 的 问题 大 大 减少 。 另 外 ，Spring 
Framework 也 有 一 些 让 拥有 较 少 AspectJ 经 验 的 团队 更 容易 组 合 基于 
annotation 的 方面 的 特性 。 

关于 AspectJ 的 全 面 探 讨 已 经 超出 本 书 范 围 。 更 多 信息 可 参见 
[AspectJ]. [Colyer]fH[Spring]. 





11.7 测试 张 动 系统 架 松 


通过 方面 式 的 手段 切 分 关注 面 的 威力 不 可 低估 。 假 使 你 能 用 POJO 
编写 应 用 程序 的 领域 逻辑 ， 在 代码 层面 与 架构 关注 面 分 离开 ， 就 有 可 能 
真正 地 用 测试 来 驱动 架构 。 采 用 一 些 新 技术 ， 束 能 将 架构 按 需 从 简单 演 
化 到 精细 。 没 必要 先 做 大 设计 (Big Design Up Front, BDUF) [18]。 实 
际 上 ，BDUF 甚 至 是 有 害 的 ， 它 阻碍 改进 ， 因 为 心理 上 会 抵制 丢弃 既成 
之 事 ， 也 因为 架构 上 的 方案 选择 影响 到 后 续 的 设计 思路 。 

建筑 设计 师 不 得 不 做 BDUF， 因 为 一 旦 建造 过 程 开始 ， 就 不 可 能 对 
大 型 物理 建筑 的 结构 做 根本 性 改动 L9]。 尽 管 软件 也 有 物理 [20] 的 一 
面 ， 只 要 软件 的 构架 有 效 切 分 了 各 个 关注 面 ， 还 是 有 可 能 做 根本 性 改动 
HJ. 

这 意味 着 我 们 可 以 从 “简单 自然 ?但 切 分 恨 好 的 架构 开始 做 软件 项 
目 ， 快 速 交 付 可 工作 的 用 户 故 事 ， 随 痢 规 模 的 增长 添加 更 多 基础 架构 。 
有 些 世 界 上 最 大 的 网 站 采用 了 精密 的 数据 缓存 、 安 全 、 虚 拟 化 等 技术 ， 
获得 了 极 高 的 可 用 性 和 性 能 ， 在 每 个 抽象 层 和 范围 之 内 ， 那 些 最 小 化 灰 
合 的 设计 都 简单 到 位 ， 效 率 和 灵活 性 也 随 之 而 来 。 

当然 ， 这 不 是 说 要 坚 无 准备 地 进入 一 个 项 目 。 对 于 总 的 履 盖 范围 、 
目标 、 项 目 进 度 和 最 终 系统 的 总 体 构架 ， 我 们 会 有 所 预期 。 不 过 ， 我 们 
必须 有 能 力 随 机 应 变 。 

EJB 早期 架构 就 是 一 种 著名 的 过 上 度 工 程 化 而 没 能 有 效 切 分 关注 面 的 
API。 在 没 能 真正 得 到 使 用 时 ， 设 计 得 再 好 的 API 也 等 于 是 杀 鸡 用 牛 
刀 。 优 秀 的 API 在 大 多 数 时 间 都 该 在 视线 之 外 ， 这 样 团 队 才能 将 创造 力 
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优化 价值 的 软件 。 

Mez, 

最 佳 的 系统 架构 由 模块 化 的 关注 面 领域 组 成 ， 每 个 关注 面 均 用 纯 
Java《〈 或 其 他 语言 ) 对 象 实现 。 不 同 的 领域 之 间 用 最 不 具有 侵害 性 的 方 
面 或 类 方面 工具 整合 起 来 。 这 种 染 构 能 测试 驱动 ， 就 像 代码 一 样 。 














11.8 优化 决策 
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不 管 是 一 座 城市 或 一 个 软件 项 目 ， 无 人 能 做 所 有 决策 。 

众所周知 ， 最 好 是 授权 给 最 有 资格 的 人 。 但 我 们 第 向 迄 记 了 ， 延 迟 
决策 至 最 后 一 刻 也 是 好 手段 。 这 不 是 懒惰 或 不 负责 ; 它 让 我 们 能 够 基于 
最 有 可 能 的 信息 做 出 选择 。 提 前 决策 是 一 种 预备 知识 不 足 的 决策 。 如 果 
决策 太 早 ， 就 会 缺少 太 多 客户 反馈 、 关 于 项 目的 思考 和 实施 经 验 。 

拥有 模块 化 关注 面 的 POJO 系 统 提供 的 敏捷 能 力 ， 人 允许 我 们 基于 最 
新 的 知识 做 出 优化 的 、 时 机 刚好 的 决策 。 决 人 的 复杂 性 也 降低 了 。 























建筑 构造 大 有 可 观 ， 既 因为 新 建筑 的 构建 过 程 〈 即 便 是 在 隆冬 季 
节 ) ， 也 因为 那些 现今 科技 所 能 实现 的 超凡 设计 。 建 筑 业 是 一 个 成 熟 行 
业 ， 有 着 高 度 优化 的 部 件 、 方 法 和 久 经 岁月 历练 的 标准 。 

即便 是 轻 量 级 和 更 直截了当 的 设计 已 足 表 使用， 许多 团队 还 是 采用 
了 EJB2 架构 ， 只 因为 EJB2 是 个 标准 。 我 见 过 一 些 团 队 ， 纠 缠 于 这 个 或 
那个 名 声 大 噪 的 标准 ， 却 丧失 了 对 为 客户 实现 价值 的 关注 。 

有 了 标准 ， 就 更 易 复 用 想法 和 组 件 、 雇 用 拥有 相关 经 验 的 人 才 、 封 
装 好 点 子 ， 以 及 将 组 件 连 接 起 来 。 不 过 ， 创 立 标 准 的 过 程 有 时 却 漫长 到 
行业 等 不 及 的 程度 ， 有 些 标准 没 能 与 它 要 服务 的 采用 者 的 真实 需求 相 结 
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Do 











建筑 ， 与 大 多 数 其 他 领域 一 样 ， 发 展 出 一 套 丰 富 的 语言 ， 有 词汇 、 
熟 语 和 清晰 而 简洁 地 表达 基础 信息 的 句 式 [21。 在 软件 领域 ， 领 域 特定 
语言 (Domain-Specific Language, DSL) [22] 最 近 重 受 关 注 。DSL 是 一 
种 单独 的 小 型 脚本 语言 或 以 标准 语言 写 束 的 API， 领 域 专 家 可 以 用 它 编 
写 读 起 来 像 是 组 织 严谨 的 散文 一 般 的 代码 。 

优秀 的 DSL 填 平 了 领域 概念 和 实现 领域 概念 的 代码 之 间 的 “壕沟 ”， 
就 像 敏 捷 实践 优化 了 开发 团队 和 甲 方 之 间 的 沟通 一 样 。 如 果 你 用 与 领域 
专家 使 用 的 同一 种 语言 来 实现 领域 逻辑 ， 就 会 降低 不 正确 地 将 领域 翻译 
为 实现 的 风险 。 

DSL 在 有 效 使 用 时 能 提升 代码 惯用 法 和 设计 模式 之 上 的 抽象 层次 。 
它 允 许 开 发 者 在 恰当 的 抽象 层级 上 直 指 代码 的 初衷 。 

领域 特定 语言 允许 所 有 抽象 层级 和 应 用 程序 中 的 所 有 和 领域， 从 高 级 
策略 到 底层 细节 ， 使 用 POJO 来 表达 。 

















11.11 小 结 


系统 也 应 该 是 整洁 的 。 侵 害 性 架构 会 潭 灭 领 域 逻 辑 ， 冲 击 敏捷 能 
力 。 当 领域 逻辑 受到 困扰 ， 质 量 也 就 堪忧 ， 因 为 缺陷 更 易 隐藏 ， 用 户 故 
事 更 难 实现 。 当 敏捷 能 力 受到 损害 时 ， 生 产 力 也 会 降低 ，TDD 的 好 处 遗 
失 殉 尽 。 

在 所 有 的 抽象 层级 上 ， 意 图 都 应 该 清晰 可 辨 。 只 有 在 编写 POJO 并 
使 用 类 方面 的 机 制 来 无 损 地 组 合 其 他 关注 面 时 ， 这 种 事情 才 会 用 生 。 

无 论 是 设计 系统 或 单独 的 模块 ， 别 筷 了 使 用 大 概 可 工作 的 最 简单 方 


案 。 
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[11./87X: [Mezzaros07]. 

[21. 原 注 : [GOF]. 

[31. 原 注 : 可 参见 [Fowler]。 

[41. 原 注 : 见 [Spring]。 另 外 也 有 一 个 Spring.NET 框 架 。 


[5]. R3: 别 筷 记 延 迟 初始 化 /赋值 只 是 一 种 优化 手段 ， 而 且 可 能 是 一 种 
不 成 熟 的 手段 。 


RE: 数据 管理 系统 。 


[71. 原 注 : 查阅 [AOSD] 获 取 有 关 方 面 的 一 般 信息 ， 查 阅 [AspectJ] 和 
[Colyer] 获 取 有 关 AspectJ 的 信息 。 


[81. 原 注 : 即 无 需 手 工 修改 源 代码 。 

[9]. 原 注 : 见 [CGLIB]、[ASM] 和 [Javassist]。 

(LO). JRE: 要 想 了 解 更 多 关于 Proxy API 及 其 用 法 ， 请 参阅 [Goetz]。 
LL1]. 原 注 ， AOP 有 时 会 与 实现 它 的 技术 相 混淆 ， 例 如 方法 拦截 和 通过 代 
AOP 系 统 的 真正 价值 在 于 用 简洁 和 模块 化 的 方式 指定 系 


(12). JRE: 见 [Spring] 和 [JBoss]。“ 纯 Java” 表 示 不 使 用 AspectJ。 





[13]. 原 注 : 摘自 http://www.theserverside.com/tt/articles/article.tss? 


|-IntrotoSpring25. 
[14]. 原 注 : [GOF]. 


[15]. 原 注 : 可 以 使 用 遵循 “约定 胜 于 配置 > 的 机 制 和 Java 5 annotation 来 减 
少 外 露 的 连接 逻辑 ， 从 而 简化 这 个 例子 。 


http://www.onjava.com/pub/a/onjava/2006/05/17/standardizing-with-ejb3- 
java-persistence-api.html. 


[171. 原 注 : 参见 [AspectJ] 和 [Colyer]。 


[8]. 原 注 : BDUF 是 一 种 预先 设计 好 一 切实 现 的 方式 ， 不 能 与 先 做 设计 
(up-front design) 的 民 好 实践 手段 相 混 清 。 


[191. 原 注 : 即便 在 构建 开始 之 后 ， 也 会 有 大 量 迭 代 陈 的 考察 和 细节 讨 


1$. 
poli: “软件 物理 ”一 词 最 早 由 [Kolence] 提 出 。 
[211. 原 注 : [Alexander] 的 著作 对 软件 社区 影响 至 深 。 


[22]. 原 注 : 参见 [DSL]。[JMock] 是 创建 DSL 的 Java API 的 优秀 范例 。 
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假使 有 4 条 简单 的 规矩 ， 跟 着 做 就 能 帮助 你 创建 优良 的 设计 ， 会 如 
何 ? 假使 遵循 这 些 规矩 你 就 能 洞 见 代 码 的 结构 和 设计 ， 更 轻易 地 应 用 
SRP 和 DIP 之 类 原则 ， 叉 会 如 何 ? 

我 们 中 的 许多 人 认为 ，Kent Beck 关 于 简单 设计 [1] 的 四 条 规则 ， 对 
于 创建 具有 良好 设计 的 软件 有 着 莫大 的 帮助 。 

据 Kent 所 述 ， 只 要 遵循 以 下 规则 ， 设 计 就 能 变 得 “简单 ”: 

运行 所 有 测试 ; 

不 可 重复 ; 

表达 了 程序 

尽 可 能 减少 

以 上 规则 按 


员 的 意图 ; 
类 和 方法 的 数量 ; 
其 重要 程度 排列 。 





设计 必须 制造 出 如 预期 一 般 工 作 的 系统 ， 这 是 首要 因素 。 系 统 也 许 
有 一 套 绝 佳 设计 ， 但 如 果 缺 乏 验证 系统 是 否 真 按 预期 那样 工作 的 简单 方 
法 ， 那 束 无 寞 于 纸上谈兵 。 

全 面 测 试 并 持续 通过 所 有 测试 的 系统 ， 就 是 可 测试 的 系统 。 看 似 小 
显 ， 但 却 重 要 。 不 可 测试 的 系统 同样 不 可 验证 。 不 可 验证 的 系统 ， 绝 不 
ERE o 
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持续 走 问 编写 较 易 测试 的 代码 。 所 以 ， 确 保 系 统 完全 可 测试 能 帮助 我 们 
创建 更 好 的 设计 。 

紧 厢 合 的 代码 难以 编写 测试 。 同 样 ， 编 写 测 试 越 多 ， 就 越 会 遵循 
DIP 之 类 规则 ， 使 用 依赖 注入 、 接 口 和 抽象 等 工具 尽 可 能 减少 耦合 。 如 
此 一 来 ， 设 计 就 有 长 足 进步 。 

章 循 有 关 编 写 测 试 并 持续 运行 测试 的 简单 、 明 确 的 规则 ， 系 统 就 会 
更 贴近 OO 低 耦 合 度 、 高 内 聚 度 的 目标 。 编 写 训 试 引 致 更 好 的 设计 。 

















有 了 测试 ， 就 能 保持 代码 和 类 的 整洁 ， 方 法 就 是 递增 式 地 重 构 代 
码 。 添 加 了 几 行 代码 后 ， 就 要 和 暂停， 琢磨 一 下 变化 了 的 设计 。 设 计 退 步 
TH? 如 果 是 ， 就 要 清理 它 ， 并 且 运 行 测试 ， 保 证 没有 破坏 任何 东西 。 
测试 消除 了 对 清理 代码 就 会 破坏 代码 的 铠 悍 。 

在 重 构 过 程 中 ， 可 以 应 用 有 关 优 秀 软 件 设计 的 一 切 知识 。 提 升 内 桶 
性 ， 降 低 厅 合 度 ， 切 分 关注 面 ， 模 块 化 系统 性 关注 面 ， 缩 小 函数 和 类 的 
尺寸 ， 选 用 更 好 的 名 称 ， 如 此 等 等 。 这 也 是 应 用 简单 设计 后 三 条 规则 的 
地 方 : 消除 重复 ， 保 证 表达 力 ， 尽 可 能 减少 类 和 方法 的 数量 。 











12.4 不 可 重复 





重复 是 拥有 良好 设计 系统 的 大 敌 。 它 代表 着 额外 的 工作 、 额 外 的 风 
险 和 额外 且 不 必要 的 复杂 度 。 重 复 有 多 种 表现 。 极 其 雷同 的 代码 行当 然 
是 重复 。 类 似 的 代码 往往 可 以 调整 得 更 相似 ， 这 样 就 能 更 容易 地 进行 重 
构 。 重 复 也 有 实现 上 的 重复 等 其 他 一 些 形 态 。 例 如 ， 在 某 个 群集 类 中 可 
能 会 有 两 个 方法 : 

int size() {} 





boolean isEmpty() {} 

这 两 个 方法 可 以 分 别 实现 。isEmpty 方 法 跟踪 一 个 布尔 值 ， 而 size 
方法 则 跟 踩 一 个 计数 器 。 或 者 ， 也 可 以 通过 在 isEmpty 中 使 用 size 方 法 来 
消除 重复 : 

boolean isEmpty() { 

return 0 == size(); 

} 

要 想 创 建 整洁 的 系统 ， 需 要 有 消除 重复 的 意愿 ， 即 便 对 于 短 短 几 行 
也 是 如 此 。 例 如 以 下 代码 : 

public void scaleToOneDimension( 

float desiredDimension, float imageDimension) { 
if (Math.abs(desiredDimension - imageDimension) < errorThreshold) 
return; 
float scalingFactor = desiredDimension / imageDimension; 
scalingFactor = (float)(Math.floor(scalingFactor * 100) * 0.01f); 
RenderedOp newImage = ImageUtilities.getScaledImage( 


image, scalingFactor, scalingFactor); 
image.dispose(); 
System.gc(); 
image = newlmage; 
} 
public synchronized void rotate(int degrees) { 
RenderedOp newImage = ImageUtilities.getRotatedImage( 
image, degrees); 
image.dispose(); 
System.gc(); 
image = newlmage; 
} 
要 保持 系统 整洁 ， 应 该 消除 scaleToOneDimension 和 rotate 方 法 里 面 
的 少量 重复 : 
public void scaleToOneDimension( 
float desiredDimension, float imageDimension) { 
if (Math.abs(desiredDimension - imageDimension) < errorThreshold) 
return; 
float scalingFactor = desiredDimension / imageDimension; 
scalingFactor = (float)(Math.floor(scalingFactor * 100) * 0.01f); 
replaceImage(ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor)); 
} 
public synchronized void rotate(int degrees) { 
replaceImage(ImageUtilities.getRotatedImage(image, 
degrees)); 
} 


private void replaceImage(RenderedOp newImage) { 
image.dispose(); 
System.gc(); 
image = newImage; 


} 


可 以 把 一 个 新 方法 分 解 到 另外 的 类 中 ， 从 而 提升 其 可 见 性 。 团 队 中 的 其 
他 成 员 也 许 会 发 现 进 一 步 抽象 新 方法 的 机 会 ， 并 且 在 其 他 场景 中 复 用 
之 。“ 小 规模 复 用 ”可 大 量 降 低 系 统 复杂 性 。 要 想 实现 大 规模 复 用 ， 必 须 
理解 如 何 实现 小 规模 复 用 。 

模板 方法 模式 [2] 是 一 种 移 除 高 层级 重复 的 通用 技巧 。 例 如 : 


public class VacationPolicy { 








public void accrueUSDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
IT. sua 
// code to ensure vacation meets US minimums 
I s 
// code to apply vaction to payroll record 
= 
} 
public void accrueEUDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
Il sa 
// code to ensure vacation meets EU minimums 
I s 
// code to apply vaction to payroll record 
= 


} 

除了 计算 法 定 最 少数 量 假期 的 部 分 ，accrueUSDivisionVacation 和 
accrueEuropeanDivision Vacation 中 有 大 量 代码 雷同 。 那 部 分 的 算法 ， 依 
据 员 工 类 型 而 变 。 

可 以 通过 应 用 模板 方法 模式 来 消除 明显 的 重复 。 


abstract public class VacationPolicy { 





public void accrueVacation() { 
calculateBaseVacationHours(); 
alterForLegalMinimums(); 
applyToPayroll(); 
} 
private void calculateBase VacationHours() 1 /* ... */ }; 
abstract protected void alterForLegalMinimums(); 
private void apply ToPayroll() { /* ... */ }; 
} 
public class USVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimums() { 
// US specific logic 


} 


public class EUVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimums() { 
// EU specific logic 


} 
子 类 填充 了 accrueVacation 算 法 中 的 “空洞 >”， 提 供 不 重 复 的 信息 。 


12.5 表达 力 


我 们 中 的 大 多 数 人 都 经 历 过 费解 代码 的 纠缠 。 我 们 中 的 许多 人 自己 
就 编写 过 费解 的 代码 。 写 出 自己 能 理解 的 代码 很 容易 ， 因 为 在 写 这 些 代 
码 时 ， 我 们 正 深入 于 要 解决 的 问题 中 。 代 码 的 其 他 维护 者 不 会 那么 深 
入 ， 也 就 不 易 理 解 代码 。 

软件 项 目的 主要 成 本 在 于 长 期 维护 。 为 了 在 修改 时 尽量 降低 出 现 缺 
陷 的 可 能 性 ， 很 有 必要 理解 系统 是 做 什么 的 。 当 系统 变 得 越 来 越 复杂 ， 
开发 者 就 需要 越 来 越 多 的 时 间 来 理解 它 ， 而 且 也 极 有 可 能 误解 。 所 以 ， 
代码 应 当 清 晰 地 表达 其 作者 的 意图 。 作 者 把 代码 写 得 越 清晰 ， 其 他 人 花 
在 理解 代码 上 的 时 间 也 就 越 少 ， 从 而 减少 缺 隐 ， 缩 减 维护 成 本 。 

可 以 通过 选用 好 名 称 来 表达 。 我 们 想 要 听 到 好 类 名 和 好 函数 名 ， 而 
且 在 查看 其 权 责 时 不 会 大 吃 一 惊 。 

也 可 以 通过 保持 函数 和 类 尺寸 短小 来 表达 。 短 小 的 类 和 函数 通常 易 
于 命 易于 编写 ， 易 于 理解 。 

还 可 以 通过 采用 标准 命名 法 来 表达 。 人 例如， 设计 模式 很 大 程度 上 就 
关乎 沟通 和 表达 。 通 过 在 实现 这 些 模式 的 类 的 名 称 中 采用 标准 模式 名 ， 
例如 COMMAND 或 VISITOR， 束 能 充分 地 回 其 他 开发 者 描述 你 的 设 
Vira 

AAA 
实例 起 到 文档 的 作用 。 读 到 测试 的 人 应 该 能 很 快 理解 某 个 类 是 做 什么 
的 。 

不 过 ， 做 到 有 表达 力 的 最 重要 方式 却 是 尝试 。 有 太 多 时 候 ， 我 们 写 
出 能 工作 的 代码 ， 就 转移 到 下 一 个 问题 上 ， 没 有 下 足 功夫 调整 代码 ， 让 
































后 来 者 易于 阅读 。 记 住 ， 下 一 位 读 代码 的 人 最 有 可 能 是 你 自己 。 

所 以 ， 多 少 尊重 一 下 你 的 手艺 吧 。 花 一 点 点 时 间 在 每 个 函数 和 类 
上 。 选 用 较 好 的 名 称 ， 将 大 函数 切 分 为 小 函数 ， 时 时 照 指 自己 创建 的 东 
西 。 用 心 是 最 珍贵 的 资源 。 





12.6 尽 可 能 少 的 类 和 方法 


即便 是 消除 重复 、 代 码 表 达 力 和 SRP 等 最 基础 的 概念 也 会 被 过 度 使 
用 。 为 了 保持 类 和 函数 短小 ， 我 们 可 能 会 造 出 太 多 的 细小 类 和 方法 。 所 
以 这 条 规则 也 主张 函数 和 类 的 数量 要 少 。 

类 和 方法 的 数量 太 多 ， 有 时 是 由 曼 无 意义 的 教条 主义 导致 的 。 例 
如 ， 某 个 编码 标准 就 坚 称 应 当 为 每 个 类 创建 接口 。 也 有 开发 者 认为 ， 字 
段 和 行为 必须 切 分 到 数据 类 和 行为 类 中。 应 该 抵制 这 类 教条 ， 采 用 更 实 
用 的 手段 。 

我 们 的 目标 是 在 保持 函数 和 类 短小 的 同时 ， 保 持 整 个 系统 短小 精 
悍 。 不 过 要 记 住 ， 这 在 关于 简单 设计 的 四 条 规则 里 面 是 优先 级 最 低 的 一 
条 。 所 以 ， 尺 管 使 类 和 函数 的 数量 尽量 少 是 很 重要 的 ， 但 更 重要 的 却 是 
测试 、 消 除 重 复 和 表达 力 。 
































12.7 小 结 


有 没有 能 丛 代 经 验 的 一 套 简 单 实 践 手段 氟 ? 当然 不 会 有 。 男 一 方 
面 ， 本 章 中 写 到 的 实践 来 目 于 本 书 作者 数 十 年 经 验 的 精练 总 结 。 遭 循 简 
单 设计 的 实践 手段 ， 开 发 者 不 必 经 年 学 习 就 能 掌握 好 的 原则 和 模式 。 
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OZ: 


t a. 
en ode 


“对 象 是 过 程 的 抽象 。 线 程 是 调度 的 抽象 。” 

James O Coplien[1] 
编写 整洁 的 并 发 程序 很 难 一 一 非常 难 。 编 写 在 单线 程 中 执行 的 代码 

简单 得 多 。 编 写 表 面 上 看 来 不 错 、 深 入 进去 却 文 离 破 碎 的 多 线程 代码 也 

简单 。 系 统一 旦 遭受 压力 ， 这 种 代码 束 打 不 住 了 。 

本 章 将 讨论 并 发 编程 的 需求 及 其 困难 之 处 ， 并 给 出 一 些 对 付 这 些 难 
点 、 编 写 整 洁 的 并 发 代码 的 建议 。 最 后 ， 我 们 将 讨论 与 测试 并 发 代码 有 
关 的 问题 。 

整洁 的 并 发 编程 是 个 复杂 话题 ， 值 得 用 一 整 本 书 来 讨论 。 本 书 只 做 
概 吃 ， 并 在 “并 及 编程 17” 一 章 中 提供 更 详细 的 指引 。 如 果 你 只 是 对 并 发 

pa RI 


好 奇 ， 阅 读本 章 就 足够 了 。 如 有 果 你 需要 更 深入 地 理解 并 发 ， 就 应 该 完整 


个 指引 章节 。 











13.1 为 什么 要 3 


并 发 是 一 种 解 耦 策略 。 它 帮助 我 们 把 做 什么 〈 目 的 ) 和 何 时 (时 
DIO 做 分 解 开 。 在 单线 程 应 用 中 ， 目 的 与 时 机 紧密 耦合 ， 很 多 时 候 只 要 
得 看 堆栈 追踪 即 可 断定 应 用 程序 的 状态 。 调 试 这 种 系统 的 程序 员 可 以 设 
定 断 点 或 者 断 点 序列 ， 通 过 查看 到 达 哪 个 断 点 来 了 解 系统 状态 。 

解 耦 目的 与 时 机 能 明显 地 改进 应 用 程序 的 吞吐 量 和 结构 。 从 结构 的 
角度 来 看 ， 应 用 程序 看 起 来 更 像 是 许多 台 协 同 工 作 的 计算 机 ， 而 不 是 一 
个 大 循环 。 系 统 因此 会 更 易于 被 理解 ， 给 出 了 许多 切 分 关注 面 的 有 力 手 
Et. 

例如 ，Web 应 用 的 Servlet 标 准 模式 。 这 类 系统 运行 于 Web 或 EJB 容 
器 的 保护 伞 之 下 ，Web 或 EJB 为 你 部 分 地 处 理 并 发 问题 。 当 有 Web 请 求 
时 ，servlet 就 会 异步 执行 。Servlet 程 序 员 无 需 管理 所 有 的 请 求 。 原 则 
上 ， 每 次 servlet 是 在 自己 的 小 世界 中 执行 ， 与 其 他 servlet 的 执行 是 分 离 
Hj. 

当然 ， 如 果 只 是 那么 简单 ， 也 就 没 必 要 写 这 一 章 了 。 实 际 上 ，Web 
容器 提供 的 解 帮 手段 离 完美 还 差 得 远 。S$ervlet 程 序 员 得 非常 警惕 、 非 党 
小 心地 保证 并 发 程序 不 出 错 。 同 样 ，servlet 模 式 的 结构 性 好 处 还 是 很 明 
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要 求 ， 需 要 手工 编写 并 发 解决 方案 。 例 如 ， 考 虑 一 个 单线 程 信息 聚合 程 
序 ， 它 从 许多 Web 站 点 获取 信息 ， 再 合并 写 入 日 志 中 。 因 为 该 系统 是 单 
线程 的 ， 它 会 逐个 访问 Web 站 点 ， 在 开始 下 一 个 之 前 等 待 当前 站 点 访问 
完毕 。 每 天 的 执行 时 间 必 须 少 于 24 个 小 时 。 然 而 ， 随 着 要 访问 的 站 点 越 








来 越 多 ， 采 和 集 所 有 数据 花费 的 时 间 也 越 来 越 多 ， 最 终 超过 了 24 个 小 时 的 
限制 。 单 线程 程序 许多 时 间 花 在 等 等 Web 套 接 字 IO 结束 上 面 。 通 过 采 
用 同时 访问 多 个 站 点 的 多 线程 算法 ， 就 能 改进 性 能 。 

或 者 ， 考 虑 某 个 每 次 花费 1 秒 钟 处 理 一 个 用 户 请 求 的 系统 。 该 系统 
在 用 户 量 较 少 的 时 候 啊 应 及 时 ， 但 随 独 用 户 数 增加 ， 系 统 的 啊 应 时 间 也 
增加 了 。 没 人 想 排 在 150 个 人 后 面 ! 通过 并 发 处 理 多 个 用 户 请 求 ， 就 能 
改进 系统 啊 应 时 间 。 

再 或 者 ， 考 虚 茶 个 解释 大 量 数 据 集 、 但 只 在 处 理 完 全 部 数据 后 给 出 
一 个 完整 解决 方案 的 系统 。 或 许可 以 在 独立 的 计算 机 上 处 理 每 个 数据 
集 ， 那 样 的 话 许 多 数据 集 就 能 并 行 地 得 到 处 理 。 

迷 思 与 误解 

看 来 有 足够 的 理由 采用 并 发 方案 。 然 而 ， 如 前 文 所 述 ， 并 发 编程 很 
难 。 如 果 你 不 那么 细心 ， 就 会 搞 出 不 堪 入 目的 东西 来 。 看 看 以 下 向 见 的 
迷 思 和 误解 : 

(1) 并 发 总 能 改进 性 能 

并 发 有 时 能 改进 性 能 ， 但 只 在 多 个 线程 或 处 理 莫 之 间 能 分 至 大 量 等 
竺 时间 的 时 候 管用 。 事 情 没 那么 简单 。 

(20 编写 并 发 程序 无 需 修改 设计 

事实 上 ， 并 发 算法 的 设计 有 可 能 与 单线 程 系统 的 设计 极 不 相同 。 目 
的 与 时 机 的 解 耦 往往 对 系统 结构 产生 巨大 影响 。 

(3) 在 采用 Web 或 EJB 容 器 的 时 候 ， 理 解 并 发 问题 并 不 重要 

实际 上 ， 你 最 好 了 解 容器 在 做 什么 ， 了 解 如 何 对 付 本 间 后 文 将 提 到 
的 并 发 更 新 、 死 锁 等 问题 。 

下 面 是 一 些 有 关 编 写 并 及 软件 的 中 肯 说 法 : 

并 发 会 在 性 能 和 编写 额外 代码 上 增加 一 些 开 销 ; 

正确 的 并 发 是 复杂 的 ， 即 便 对 于 简单 的 问题 也 是 如 此 ; 

并 发 缺陷 并 非 总 能 重 现 ， 所 以 利和 被 看 做 偶发 事件 D] 而 忽略 ， 未 被 当 


























做 真 的 缺陷 看 竺 ; 
并 发 常常 需要 对 设计 策略 的 根本 性 修改 。 





13.2 挑战 


并 发 编程 为 何如 此 之 难 ? 来 看 看 下 面 这 个 小 型 类 : 
public class X { 

private int lastIdUsed; 

public int getNextId() { 


return ++lastIdUsed; 


} 

比如 ， 创 建 x 的 一 个 实体 ， 将 lastIdUsed 设 置 为 42， 在 两 个 线程 中 共 
享 这 个 实体 。 假 设 这 两 个 线程 都 调用 getNextId( ) 方 法 ， 结 果 可 能 有 三 种 
输出 : 

线程 一 得 到 值 43， 线 程 二 得 到 值 44，lastIdUsed 为 44:; 

线程 一 得 到 值 44， 线 程 二 得 到 值 43，lastIdUsed 为 44:; 

线程 一 得 到 值 43， 线 程 二 得 到 值 43，]lastIdUsed 为 43。 

第 三 种 结果 令 人 惊异 [3]， 当 两 个 线程 相互 影响 时 就 会 出 现 这 种 情 
况 。 这 是 因为 线程 在 执行 那 行 Java 代 码 时 有 许多 可 能 路 径 可 行 ， 有 些 路 
径 会 产生 错误 的 结果 。 有 多 少 种 不 同 路 径 呢 ? 要 真正 回答 这 个 问题 ， 需 
要 理解 Just-In-Time 编译 器 如 何 对 待 生 成 的 字 节 码 ， 还 要 理解 Java 内 存 
模型 认为 什么 东西 具有 原子 性 。 

简 答 一 下 ， 就 生成 的 字 节 码 而 言 ， 对 于 在 getNextId 方 法 中 执行 的 那 
两 个 线程 ， 有 12870 种 不 同 的 可 能 执行 路 径 [ 册 。 如 果 lastIdUsed 的 类 型 从 
int 变 为 1ong， 则 可 能 路 径 的 数量 将 增 至 2704156 种 。 当 然 ， 多 数 路 径 都 
得 到 正确 结果 。 问 题 是 其 中 一 些 不 能 得 到 正确 结果 。 








13.3 RIA 


下 面 给 出 一 系列 防御 并 发 代码 问题 的 原则 和 技巧 。 
13.3.1 单一 权 责 原 见 


单一 权 责 原则 (SRP) WAN, FIERA YS RAMEY 
理由 。 并 发 设计 目 喘 足够 复杂 到 成 为 修改 的 理由 ， 所 以 也 该 从 其 他 代码 
Hop aR. ANS ANE, FRACS ELAN E 6 ERRA SIUG T r7 (R3 
中 。 下面 是 要 考虑 的 一 些 问 题 : 

并 发 相关 代码 有 上 自己 的 开发 、 修 改 和 调 优生 命 周 期 ; 

开发 相关 代码 有 目 己 要 对 付 的 挑战 ， 和 非 并 发 相关 代码 不 同 ， 而 且 

即便 没有 周边 应 用 程序 增加 的 负担 ， 写 得 不 好 的 并 发 代码 可 能 的 出 
间 方 式 数 量 也 已 经 足 具 挑战 性 。 

建议 : 分 离 并 发 相关 代码 与 其 他 代码 [6]。 














如 我 们 所 见 ， 两 个 线程 修改 共享 对 象 的 同一 字段 时 ， 可 能 互相 干 
扰 ， 导 致 末 预 期 的 行为 。 解 决 方案 之 一 是 采用 synchronized 关键 字 在 代 
码 中 保护 一 块 使 用 共享 对 象 的 临界 区 (critical section) 。 限 制 临 界 区 的 
数量 很 重要 。 更 新 共享 数据 的 地 方 越 多 ， 惑 越 可 能 : 

你 会 忘记 保护 一 个 或 多 个 临界 区 一 一 破坏 了 修改 共享 数据 的 代码 ; 

得 多 花 力气 保证 一 切 都 受到 有 效 防护 (破坏 了 DRY 原 则 [71》; 

很 难 找 到 错误 源 ， 也 很 难 判 断 错 误 源 











建议 : EWA es PRSE RI RAEE ID, 
13.3.3 推论 ;使 用 数据 复 本 


避免 共享 数据 的 好 方法 之 一 就 是 一 开始 就 避免 共 孚 数据 。 在 茶 些 情 
形 下 ， 有 可 能 复制 对 象 并 以 只 读 方 式 对 符 。 在 另外 的 情况 下 ， 有 可 能 
制 对 象 ， 从 多 个 线程 收集 所 有 复 本 的 结果 ， 并 在 单个 线程 中 合并 这 些 结 
果 。 

如 果 有 避免 共享 数据 的 简易 手段 ， 结 果 代 码 就 会 大 大 减少 导致 错误 
的 可 能 。 你 可 能 会 关心 创建 额外 对 象 的 成 本 。 值 得 试验 一 下 看 看 那 是 合 
真是 个 问题 。 然 而 ， 假 使 使 用 对 象 复 本 能 避免 代码 同步 执行 ， 则 因 避 免 
了 锁定 而 省 下 的 价值 有 可 能 补偿 得 上 额外 的 创建 成 本 和 垃圾 收集 开销 。 














证 每 个 线程 在 目 己 的 世界 中 存在 ， 不 与 其 他 线程 共享 数据 。 每 个 线 
程 处 理 一 个 客户 端 请 求 ， 从 不 共享 的 源头 接纳 所 有 请 求 数 据 ， 存 储 为 本 
地 变量 。 这 样 一 来 ， 每 个 线程 都 像 是 世界 中 的 唯一 线程 ， 没 有 同步 需 





要 。 
例如 ，HttpServlet 的 子 类 接收 所 有 以 参数 形式 传递 给 doGet 和 doPost 
方法 的 信息 。 每 个 Servlet 都 像 拥 有 独立 虚拟 机 一 般 运 行 。 只 要 Servlet 中 





的 代码 只 使 用 本 地 变量 ，Servlet 束 不 会 导致 同步 问题 。 当 然 ， 多 数 使 用 
Servlet 的 应 用 程序 最 终 都 还 是 会 用 到 类 似 数据 库 连 接 之 类 的 共 孚 资源 。 

建议 : 党 试 将 数据 分 解 到 可 被 独立 线程 〈 可 能 在 不 同 处 理 器 上 ) $E 
作 的 独立 子 集 。 


13.4 _{ fit Java 


相对 于 之 前 的 版 本 ，Java 5 提供 了 许多 并 发 开发 方面 的 改进 。 在 用 
Java 5 编写 线程 代码 时 ， 要 注意 以 下 几 点 : 

使 用 类 库 提 供 的 线程 安全 群集 ; 

使 用 executor 框 架 (executor framework) 执行 无 关 任务 ; 

尽 可 能 使 用 非 锁定 解决 方案 ; 

有 几 个 类 并 不 是 线程 安全 的 。 

线程 安全 群集 

当 Java 还 年 轻 时 ，Doug  LeaZW*j [| Concurrent Programming in 
Java〔 中 译 版 《Java 并 发 编程 》) 教程 [8]， 同 时 开发 了 几 个 线程 安全 和 群 
集 ， 这 些 代码 后 来 成 为 JDK 中 java.util.concurrent 包 的 一 部 分 。 该 代码 包 
中 的 群集 对 于 多 线程 解决 方案 是 安全 的 ， 执 行 妇 好。 实际 上 ， 在 几乎 所 
有 情况 下 ，ConcurrentHashMap 实 现 都 比 HashMap 表 现 得 好 。 它 还 文 持 
同步 并 发 谈 写 ， 也 拥有 文 持 非 线程 安全 的 合成 操作 的 方法 。 如 有 条 部 署 环 
境 是 Java 5， 可 以 采用 ConcurrentHashMap。 

还 有 几 个 支持 高 级 并 发 设计 的 类 。 以 下 是 其 中 一 小 部 分 ， 如 表 13-1 
Pro 











表 13-1 支持 高 级 并 发 设计 的 类 《部 分 ) 





ReentrantLock 可 在 一 个 方法 中 获取 、 在 另 一 方法 中 释放 的 锁 
Semaphore 经 典 的 “信号 ”的 一 种 实现 ， 有 计数 器 的 锁 





CountDownLatch ”| 在 释放 所 有 等 待 的 线程 之 前 ， 等 待 指定 数量 事件 发 生 的 锁 。 这 样 ， 所 有 线程 都 平等 
地 几乎 同时 启动 


建议 : 检 读 可 用 的 类 。 对 于 Java， 掌 握 java.util.concurrent、 


java.util.concurrent.atomic 和 java.util.concurrent.locks 。 








13.5 了 解 执行 模型 
有 几 种 在 并 发 应 用 中 切 分 行为 的 途径 。 要 讨论 这 些 途径 ， 我 们 需要 
理解 一 些 基础 定义 ， 如 表 13-2 所 示 。 


表 13-2 基础 定义 
限定 资源 并 发 环境 中 有 着 固定 尺寸 或 数量 的 资源 。 例 如 数据 库 连接 和 固定 尺寸 读 / 写 缓存 等 


























Hm 每 一 时 刻 仅 有 一 个 线程 能 访问 共享 数据 或 共享 资源 

线程 饥饿 一 个 或 一 组 线程 在 很 长 时 间 内 或 永久 被 茶 止 。 例 如 ， 总 是 让 执行 得 快 的 线程 先 运行 ， 
假如 执行 得 快 的 线程 没完 没 了 ， 则 执行 时 间 长 的 线程 束 会 “ 挨 饿 ” 

死 锁 两 个 或 多 个 线程 互相 等 待 执 行 结束 。 每 个 线程 都 拥有 其 他 线程 需要 的 资源 ， 得 不 到 


其 他 线程 拥有 的 资源 ， 就 无 法 终止 








活 锁 执行 次 序 一 致 的 线程 ， 每 个 都 想 要 起 步 ， 但 发 现 其 他 线程 已 经 “在 路 上 ”。 由 于 竞 
步 的 原因 ， 线 程 会 持续 尝试 起 步 ， 但 在 很 长 时 间 内 却 无 法 如 愿 ， 甚 至 永远 无 法 启动 


有 了 这 些 定 义 ， 我 们 就 能 讨论 在 并 发 编程 中 用 到 的 几 种 执行 模型 
To 














13.5.1 生产 者 -消费 者 模型 


[9] 

一 个 或 多 个 生产 者 线程 创建 某 些 工作 ， 并 置 于 缓存 或 队列 中 。 一 个 
或 多 个 消费 者 线程 从 队列 中 获取 并 完成 这 些 工作 。 生 产 者 和 消费 者 之 间 
的 队列 是 一 种 限定 资源 。 








13.5.2 读者 - Fa 


[10] 
当 存 在 一 个 主要 为 读者 线程 提供 信息 源 ， 但 只 偶尔 被 作者 线程 更 新 











的 共 训 资源， 吞吐 量 就 会 是 个 问题 。 增 加 吞吐 量 ， 会 导致 线程 饥饿 和 过 
时 信息 的 累积 。 更 新 会 影响 吞吐 量 。 协 调 读者 线程 ， 不 去 读 作者 线程 正 
在 更 新 的 信息 《反之 亦 然 ) ， 这 是 一 种 注 否 的 平衡 工作 。 作 者 线程 倾 问 
于 长 期 锁定 许多 读者 线程 ， 从 而 导致 看 叶 量 问题 。 

挑 成 之 处 在 于 平衡 读者 线程 和 作者 线程 的 需求 ， 实 现 正确 操作 ， 提 
供 合理 的 厨 吐 量 ， 避 免 线程 饥饿 。 

















13.5.3 宴席 哲学 家 


[11] 
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进食 。 如 果 左 边 或 右边 的 哲学 家 已 经 取 用 一 把 叉子， 中间 这 位 就 得 等 到 
别人 吃 完 、 放 回 叉子 。 每 位 哲学 家 吃 完 后 ， 就 将 两 把 又 子 放 回 梨 面 ， 直 
到 肚子 再 饿 。 

用 线程 代 丛 哲学 家 ， 用 资源 代 丛 又 子 ， 就 变 成 了 许多 企业 级 应 用 中 
进程 竞争 资源 的 情形 。 如 果 没 有 用 心 设计 ， 这 种 竞争 式 系 统 就 会 遭遇 死 
锁 、 活 锁 、 吞 吐 量 和 效率 降低 等 问题 。 

你 可 能 遇 到 的 并 发 问题 ， 大 多 数 都 是 这 三 个 问题 的 变种 。 请 研究 并 
使 用 这 些 算 法 ， 这 样 ， 遇 到 并 发 问题 时 你 就 能 有 解决 问题 的 准备 了 。 

建议 : 学 习 这 些 基础 算法 ， 理 解 其 解雇 方案 。 





























同步 方法 之 间 的 依赖 会 导致 并 及 代码 中 的 狐 独 缺陷 。Java _ 
synchronized 概 念 ， 可 以 用 来 保护 单个 方法 。 然 而 ， 如 果 在 同一 共享 类 
中 有 多 个 同步 方法 ， da EGA A IEW S112]. 

建议 : 避免 使 用 一 个 共享 对 象 的 多 个 方法 。 

i 在 这 种 情况 发 生 时 ， 有 3 
种 写 对 代码 的 手段 : 

基于 客户 端的 锁定 一 一 客户 端 代码 在 调用 第 一 个 方法 前 锁定 服务 
端 ， 确 保 锁 的 范围 履 盖 了 调用 最 后 一 个 方法 的 代码 ; 

基于 服务 端的 锁定 一 一 在 服务 端 内 创建 锁定 服务 问 的 方法 ， 调 用 所 
有 方法 ， 然 后 解锁 。 LL. 前 代码 调用 新 方法 ; 
炎 定 的 中 间 层 。 这 是 一 种 基于 服务 端的 锁 
定 的 例子 ， ean IRA ia LAS 


























关键 字 synchronized 制 造 了 锁 。 同 一 个 锁 维 护 的 所 有 代码 区 域 在 任 
一 时 刻 保证 只 有 一 个 线程 执行 。 锁 是 昂 贯 的 ， 因 为 它们 市 来 了 延迟 和 和 额 
外 开销 。 所 以 我 们 不 愿 将 代码 扔 给 synchronized 语 句 了 事 。 男 一 方面 ， 
临界 区 [13] 应 该 被 保护 起 来 。 所 以 ， 应 该 尽 可 能 少 地 设计 临界 区 。 

有 些 天 真 的 程序 员 想 通过 扩大 临界 区 面积 达到 这 个 目的 。 然 而 ， 将 
同步 延展 到 最 小 临界 区 范围 之 外 ， 会 增加 资源 争 用 、 降 低 执行 效率 
[14]。 

建议 :， 尺 可 能 减 小 同步 区 域 。 











编写 永远 运行 的 系统 ， 与 编写 运行 一 段 时 间 后 平静 地 关闭 的 系统 是 
两 码 事 。 

平静 关闭 很 难 做 到 。 第 见 问 题 与 死 锁 LL5] 有 关 ， 线 程 一 直 等 竺 永远 
不 会 到 来 的 信号 。 

例如 ， 想 象 一 个 系统 中 有 个 父 线 程 分 裂 出 数 个 子 线 程 ， 父 线程 等 待 
所 有 子 线程 结束 ， 然 后 释放 资源 并 关闭 。 如 果 其 中 一 个 子 线程 及 生死 锁 
会 怎样 ? 父 线 程 将 一 直 等 竺 下 去 ， 而 系统 就 永远 不 能 关闭 。 

或 者 ， 考 虑 一 个 被 指示 关闭 的 类 似 系 统 。 父 线程 告知 全 体 子 线程 放 
弃 任务 并 结束 。 如 果 其 中 两 个 子 线程 正 以 生产 者 /消费 者 模型 操作 会 怎 
样 呢 ? 假设 生产 者 线程 从 父 线 程 处 接收 到 信和 号， 并 迅速 关闭 。 消 费 者 线 
程 可 能 还 在 等 待 生产 者 线程 发 来 消息 ， 于 是 就 被 锁定 在 无 法 接收 到 关闭 
信号 的 状态 中 。 它 会 死 等 生产 者 线程 ， 永 不 结束 ， 从 而 导致 父 线程 也 无 
法 结 

这 类 情形 并 非 那 么 不 常见 。 如 果 你 要 编写 涉及 平静 关闭 的 并 友 代 
码 ， 请 多 预 留 一 些 时 间 搞 对 关闭 过 程 。 

建议 : 尽早 考虑 关闭 问题 ,尽早 令 其 工作 正 第 。 这 会 花费 比 你 预期 
更 多 的 时 间 。 检 视 既 有 算法 ， 因 为 这 可 能 会 比 想 象 中 难得 多 。 

















证 明代 码 的 正确 性 不 切实 际 。 测 试 并 不 能 确保 正确 性 。 然 而 ， 好 的 
测试 却 能 尽量 降低 风险 。 这 对 于 所 有 单线 程 解决 方案 都 是 对 的 。 当 有 两 
个 或 多 个 线程 使 用 同一 代码 段 和 共 孕 数据， 事情 就 变 得 非常 复杂 了 。 

EN: 编写 有 潜力 曝露 问题 的 测试 ， 在 不 同 的 编程 配置 、 系 统 配置 
和 负载 条 件 下 频 系 运行 。 如 果 测 斌 失败， 跟踪 错误 。 列 因为 后 来 测试 通 
过 了 后 来 的 运行 就 忽略 失败 。 

有 一 大 堆 问 题 要 考虑 。 下 面 是 一 些 精练 的 建议 : 

将 伪 失 败 看 作 可 能 的 线程 问题 ; 

先 使 非 线 程 代码 可 工作 ; 

编写 可 插 拔 的 线程 代码 ; 

编写 可 调整 的 线程 代码 ; 

运行 多 于 处 理 器 数量 的 线程 ; 

在 不 同 平台 上 运行 ; 

调整 代码 并 强迫 错误 发 生 。 





13.9.1 将 1 








线程 代码 导致 “不 可 能 失败 的 ?失败 。 多 数 开发 者 缺乏 有 关 线 程 如 何 
与 其 他 代码 《可 能 由 其 他 作者 编写 ) 互动 的 直觉 。 线 程 代 码 中 的 缺陷 可 
能 在 一 干 或 一 百 万 次 执行 中 才 会 显现 一 次 。 重 复 执行 想 要 复 现 问题 令 人 
诅 背 。 所 以 开发 者 冲冲 会 将 失败 归咎 于 宇宙 射线 、 人 硬件 错 误 或 其 他 “ 偶 
发 事件 ”。 最 好 假设 这 种 偶发 事件 根本 不 存在 。“ 偶 发 事件 ” 航 忽 略 得 越 
和 久 ， 代 码 就 越 有 可 能 搭建 于 不 完善 的 基础 之 上 。 














建议 : 不 要 将 系统 错误 归咎 于 偶发 事件 。 





13.9.2 线程 代码 可 工 


这 看 起 来 太 浅 显 ， 但 强调 一 下 不 无 益处 。 确 保 线 程 之 外 的 代码 可 工 
作 。 通 常 ， 这 意味 首创 建 由 线程 调用 的 POJO。POJO 与 线程 无 涉 ， 所 以 
可 在 线程 环境 之 外 测试 。 能 放 进 POJO 中 的 代码 越 多 越 好 。 

建议 : 不 要 同时 追踪 非 线 程 缺 陷 和 线程 缺陷 。 确 保 代 码 在 线程 之 外 
BIL ts 











编写 可 在 数 个 配置 环境 下 运行 的 线程 代码 : 

单线 程 与 多 个 线程 在 执行 时 不 同 的 情况 ; 

线程 代码 与 实物 或 测试 蔡 喘 互动 ; 

用 运行 快速 、 绥 慢 和 有 变动 的 测试 蔡 里 执行 ; 

将 汕 试 配置 为 能 运行 一 定数 量 的 迭代 。 

建议 :编写 可 插 拔 的 线程 代码 ， 这 样 就 能 在 不 同 的 配置 环境 下 运 











要 获得 民 好 的 线程 平衡 ， 常 常 需要 试 错 。 一 开始 ， 在 不 同 的 配置 环 
境 下 监测 系统 性 能 。 要 允许 线程 数量 可 调整 。 在 系统 运行 时 允许 线程 发 
生变 动 。 允 许 线程 依据 吞吐 量 和 系统 使 用 率 自 我 调整 。 











系统 在 切换 任务 时 会 发 生 一 些 事 。 为 了 促使 任务 交换 的 发 生 ， 运 行 
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错过 临界 区 或 导致 死 锁 的 代码 。 





2007 年 ， 我 们 做 了 一 套 关 于 并 发 编程 的 课程 。 该 课程 主要 在 OS X 
下 开发 ， 在 运行 于 虚拟 机 的 Windows XP 上 展示 。 用 于 演示 的 测试 失败 
条 件 ， 在 OS XX 上 要 比 在 XP 上 失败 得 更 频繁 。 

被 测试 的 代码 已 知 是 不 正确 的 。 这 正 强 调 了 不 同 操 作 系 统 有 着 不 同 
线程 策略 的 事实 ， 不 同 的 线程 策略 影响 了 代码 的 执行 。 在 不 同 环境 中 ， 
多 线程 代码 的 行为 也 不 一 样 [16]。 应 该 在 所 有 可 能 部 署 的 环境 中 运行 测 
Me 

建议 : 尽早 并 经 常 地 在 所 有 目标 平台 上 运行 线程 代码 。 
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并 发 代码 中 藏 有 缺陷 ， 这 并 不 罕见 。 简 单 的 测试 往往 无 法 曝露 这 些 
缺陷 。 实 际 上 ， 缺 陷 经 常 隐 藏 于 一 般 处 理 过 程 中 。 可 能 好 几 个 小 时 、 好 
几 天 甚至 好 几 个 星期 才 会 跳出 来 一 次 ! 

线程 中 的 缺陷 之 所 以 如 此 不 频繁 、 侦 发、 难以 重 现 ， 是 因为 在 几 千 
个 罕 过 脆弱 区 域 的 可 能 路 径 当 中 ， 只 有 少数 路 径 会 真 的 导致 失败 。 经 过 
会 叶 致 失败 的 路 径 的 可 能 性 惊人 地 低 。 所 以 ， 侦 测 与 调试 也 非常 之 难 。 

怎么 才能 增加 捕捉 住 如 此 罕见 之 物 的 机 会 ?可 以 装置 代码 ， 增 加 对 
Object.wait( ). Object.sleep(). Object.yield( )fllObject.priority( ) 等 方法 的 
调用 ， 改 变 代码 执行 顺序 。 

这 些 方法 都 会 影响 执行 顺序 ， 从 而 增加 了 侦 测 到 缺陷 的 可 能 性 。 有 
问题 的 代码 ， 最 好 尽早 、 尽 可 能 多 地 通 不 过 测试 。 

有 两 种 装置 代码 的 方法 : 























便 编码 ; 
目 动 化 。 


13.9.8 便 编 码 


你 可 以 手工 向 代码 中 插入 wait( ). sleep( ). yield( ) 和 priority( ) 的 调 
用 。 在 测试 菜 段 杯 手 的 代码 时 ， 正 当 如 此 操作 。 
下 面 是 个 例子 : 
public synchronized String nextUrlOrNull() { 
if(hasNext()) { 
String url = urlGenerator.next(); 
Thread.yield(); // inserted for testing. 
updateHasNext(); 
return url; 
} 
return null; 
} 
插入 对 yield( ) 的 调用 ， 将 改变 代码 的 执行 路 径 ， 由 此 而 可 能 导致 代 
码 在 以 前 未 失败 过 的 地 方 失败 。 如 果 代 码 的 确 出 错 ， 那 并 非 是 因为 你 插 
入 了 yield( ) 方 法 调用 [171]。 代 码 出 错 了 ， 这 便 是 失败 的 原因 。 
这 种 手法 有 许多 毛病 : 
你 得 手工 找到 合适 的 地 方 来 插入 方法 调用 ; 
你 怎么 知道 在 哪里 插入 调用 、 插 入 什么 调用 ? 
不 必要 地 在 产品 环境 中 留 下 这 类 代码 ， 将 拖 慢 代码 执行 速度 ; 
这 是 种 无 的 放 和 天 的 手段 。 你 可 能 找 不 到 缺陷 。 实 际 上 ， 这 不 在 你 把 
握 之 中 。 
我 们 所 需要 的 ， 是 一 种 在 测试 中 但 不 在 生产 中 实现 的 手段 。 我 们 还 











需要 为 多 次 运行 轻易 地 调整 配置 ， 从 而 增加 总 的 发 现 错误 机 会 。 

无 疑 ， 如 果 将 系统 分 解 为 对 线程 及 控制 线程 的 类 一 无 所 知 的 
POJO， 就 能 更 容易 地 找到 装置 代码 的 位 置 。 而 且 ， 还 能 创建 许多 个 以 
不 同方 式 调用 sleep、yield 等 方法 的 POJO 测 试 。 


13.9.9 目 动 化 





可 以 使 用 Aspect-Oriented Framework、CGLIB 或 ASM 之 类 工具 通过 
编程 来 装置 代码 。 例 如 ， 可 以 使 用 有 单个 方法 的 类 : 
public class ThreadJigglePoint { 
public static void jiggle() { 
} 
} 
可 以 在 代码 的 不 同位 置 调用 这 个 方法 : 
public synchronized String nextUrlOrNull() 1 
if(hasNext()) 1 
ThreadJiglePoint.jiggle(); 
String url = urlGenerator.next(); 
ThreadJiglePoint.jiggle(); 
updateHasNext(); 
ThreadJiglePoint.jiggle(); 
return url; 
} 
return null; 
} 
如 此 ， 你 就 得 到 了 一 个 随机 选择 无 所 作为 、 睡 虐 或 让 步 的 方面 。 
或 者 ， 想 象 ThreadJigglePoint 类 有 两 种 实现 。 第 一 种 实现 jiggle 什 么 


都 不 做 ， 在 生产 环境 中 使 用 。 第 二 种 实现 生成 一 个 随机 数 ， 在 睡眠 、 让 
步 或 径直 执行 间 做 选择 。 如 果 上 于 次 地 做 这 种 随机 测试 ， 大 概 就 能 找到 
一 些 缺 陷 的 根源 。 假 如 测试 都 通过 了 ， 至 少 你 可 以 说 自己 已 谨慎 对 待 。 
这 种 方法 看 似 有 点 过 于 简单 ， 但 确 是 替代 复杂 工具 的 一 种 可 选 方案 。 

有 一 种 叫做 ConTest[18] 的 工具 ， 由 IBM 开 发 ， 能 做 类 似 的 事情 ， 但 
做 法 却 稍微 复杂 些 。 

要 点 是 让 代码 “异动 "从 而 使 线程 以 不 同 次 序 执行 。 编 写 良 好 的 测 
试 与 “异动 * 相 组 合 ， 能 有 效 地 增加 发 现 错误 的 机 会 。 

建议 : 使 用 异动 策略 搜 出 错误 。 











13.10 小 结 


并 发 代码 很 难 写 正确 。 加 入 多 线程 和 共享 数据 后 ， 简 单 的 代码 也 会 
变 成 墨 梦 。 要 编写 并 发 代码 ， 葡 得 严格 地 编写 整洁 的 代码 ， 人 否则 将 面临 
微细 和 不 频 楷 用 生 的 失败 。 

第 一 要 诀 是 遵循 单一 权 责 原则 。 将 系统 切 分 为 分 离 了 线程 相关 代码 
和 线程 无 关 代 码 的 POJO。 确 保 在 测试 线程 相关 代码 时 只 是 在 测试 ， 没 
有 做 其 他 事情 。 线 程 相关 代码 应 该 保持 短小 和 目的 集中 。 

了 解 并 用 问题 的 可 能 原因 : 对 共享 数据 的 多 线程 操作 ， 或 使 用 了 公 
共 资 源 池 。 类 似 平静 关闭 或 停止 循环 之 类 边界 情况 尤其 国手 。 

学 习 类 库 ， 了 解 基 本 算法 。 理 解 类 库 提供 的 与 基础 算法 类 似 的 解决 
问题 的 特性 。 

学 习 如 何 找到 必须 锁定 的 代码 区 域 并 锁定 之 。 不 要 锁定 不 必 锁 定 的 
代码 。 避 免 从 锁定 区 域 中 调用 其 他 锁定 区 域 。 这 需要 深刻 理解 茶 物 是 否 
己 共 享 。 尽 可 能 减少 共享 对 象 和 共 宇 范围 。 修 改 对 象 的 设计 ， 回 客户 代 
码 提供 共 至 数据， 而 不 是 迫使 客户 代码 管理 共享 状 态 。 

问题 会 跳出 来 。 那 种 在 早期 没 跳出 来 的 问题 往往 是 偶发 的 。 这 种 所 
请 偶 肥 问题， 通常 仅 在 高 负载 下 出 现 或 者 侦 然 出 现 。 所 以 ， 你 要 能 在 不 
同 平台 上 、 以 不 同 配置 持续 重复 运行 线程 代码 。 跟 随 TDD 三 要 则 而 来 
的 可 测试 性 意味 着 菏 种 程度 的 可 插 拔 性 ， 从 而 提供 了 在 大 量 不 同 配 置 下 
运行 代码 的 必要 支持 。 

如 果 人 花 点 时 间 装 置 代码 ， 就 能 极 大 地 提升 发 现 错误 代码 的 机 会 。 可 
以 手工 做 ， 也 可 以 使 用 东 种 目 动 化 技术 。 尽 早 这 么 做 。 在 将 线程 代码 投 
入 生产 环境 前 ， 就 要 尽 可 能 多 地 运行 它 。 























REX TESTI, OMA AY BE PERA RRA AI hEm o 


13.11 文献 


[Lea99]: Concurrent Programming in Java: Design Principles and 
Patterns, 2d. ed., Doug Lea, Prentice Hall, 1999. 

[PPP]: Agile Software Development:Principles,Patterns,and 
Practices, Robert C.Martin,Prentice Hall, 2002. 

[PRAG]: The Pragmatic Programmer, Andrew Hunt,Dave 
Thomas, Addison-Wesley,2000. 





LURE: 来 自私 人 邮件 。 

[21. 原 注 : 宇宙 射线 、 狼 来 了 等 。〈 译 者 按 : 作者 在 这 里 开 了 个 小 玩 
笑 。 程 序 员 常 把 不 能 复 现 的 程序 错误 的 原因 归结 为 宇宙 财 线 等 偶 及 性 和 
无 法 修正 的 问题 。) 

BIRRE: WE TRA TSI” — n. 


ARE: 见 后 文 “ 路 径 数量 ”一 节 。 





[5]. 原 注 : [PPP]. 

[6]. 原 注 : 参见 后 文 “客户 端 /服务 器 的 例子 ”一 节 。 

[7]. 原 注 : [PRAG]. 

[8]. 原 注 : [Lea99]。 

[91. 原 注 : http://en.wikipedia.org/wiki/Producer-consumer. 

[10]. 原 注 : http://en.wikipedia.org/wiki/Readers-writers_problem. 


[11]. 原 注 : http://en.wikipedia.org/wiki/Dining_philosophers_problem. 


(12). EE: 参见 后 文 “方法 之 间 的 依赖 可 能 破坏 同步 代码 ”一 市 。 

LIS). JRE: 临界 区 是 为 了 确保 程序 正确 而 要 阻止 同时 使 用 的 代码 区 域 。 
HAJEE: 见 后 文 “增加 吞吐 量 ” 一 节 。 

[15]. 原 注 :; 参见 附录 A“ 死 锁 ” 一 节 。 

[161. 原 注 : 你 是 否 知 道 ，Java 的 线程 模型 并 不 保证 线程 抢先 ? 现代 操作 
系统 文 持 抢先 线程 ， 所 以 你 可 以 “免费 ”获得 这 一 特性 。 即 便 如 此 ，JVM 
也 没有 做 出 保证 。 

[1L71. 原 注 : 严格 说 来 并 非 如 此 。JVM 不 保证 抢先 线程 ， 故 在 不 抢占 线程 


的 系统 上 ， 某 个 特殊 的 算法 可 能 一 直 能 工作 。 反 之 亦 然 ， 但 会 有 其 他 的 
原因 影响 。 











[18]. 原 注 : http://www.alphaworks.ibm.com/tech/contest。 


第 14 音 逐步 改 进 


对 一 个 命令 行 参 数 解析 程序 的 案例 研 完 


KOS 
ZX % Coy 
D 


CN 
7 a v GUT 
4 


M 
4 
‘retta 







EA 





本 章 研究 一 个 逐步 改进 的 案例 。 你 将 看 到 一 个 开始 还 不 错 ， 规 模 扩 - 
大 后 即 出 问题 的 模块 。 你 还 将 看 到 这 个 模块 是 如 何 被 重 构 得 整洁 起 来 
的 。 

我 们 中 的 大 多 数 人 都 会 遇 到 解析 命令 行 参 数 的 情况 。 如 果 没 有 就 手 
的 工具 ， 就 得 过 历 传 入 main 函 数 的 字符 串 数 组 。 有 一 些 不 同 来 源 的 好 工 
具 ， 但 没有 一 个 是 最 符合 要 求 的 。 所 以 ， 我 当然 要 自己 写 一 个 。 我 把 它 
叫做 Args。 

Args 非 常 易于 使 用 。 你 只 要 简单 地 用 输入 参数 和 格式 化 字符 串 构造 
Args 类 ， 再 癌 Args 实 体 询问 参数 值 即 可 。 看 看 下 面 的 简单 例子 : 








代码 清单 14-1 Args 的 简单 用 法 
public static void main(String[] args) { 
try { 
Argsarg = new Args("l,p#,d*", args); 
boolean logging = arg.getBoolean('l'); 
intport = arg.getInt('p'); 
Stringdirectory = arg.getString('d'); 
executeApplication(logging, port, directory); 
} catch (ArgsException e) { 


System.out.printf("Argumenterror:%s\n", e.errorMessage()); 


} 

可 以 看 到 这 有 多 简单 。 我 们 只 是 用 两 个 参数 创建 了 Args 类 的 一 个 实 
体 。 第 一 个 参数 是 格式 字符 串 ， 或 范式 字符 串 : 1,p#,d*。 它 定义 了 三 个 
命令 行 参数 。 第 一 个 ，-1， 是 一 个 布尔 值 参 数 。 第 二 个 ，-p， 是 一 个 整 
数 参数 。 第 三 个 ，-d4， 是 一 个 字符 串 参 数 。 癌 Args 构 造 器 传 入 的 第 二 个 
参数 就 是 向 main 传 入 的 命令 行 参数 数组 。 

如 果 构 造 器 正常 返回 ， 没 有 抛 出 ”ArgsException 异 常 ， 则 命令 行 参 
数 已 传 入 ，Args 实体 随时 待命 。 使 用 getBoolean、getInteger 和 getString 
等 方法 ， 可 以 用 参数 名 称 获得 参数 值 。 

不 管 是 格式 化 字符 串 或 命令 行 参数 出 现 问题 ， 束 会 抛 出 一 个 
ArgsFException 寞 常 。 可 以 从 该 异常 的 errorMessage 中 获得 天 于 错误 的 描 


14.1 Args 的 实现 


代码 清单 14-2 是 Args 类 的 实现 。 请 仔细 阅读 。 我 在 代码 风格 和 结构 
上 花 了 大 力气 ， 使 之 值得 仿效 。 
代码 清单 14-2 Args.java 
package com.objectmentor.utilities.args; 
import static 
com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 
import java.util.*; 
public class Args { 
private Map<Character, ArgumentMarshaler> marshalers; 
private Set<Character> argsFound; 
private ListIterator<String> currentArgument; 
public Args(String schema, String[] args) throws ArgsException { 
marshalers = new HashMap<Character, ArgumentMarshaler>(); 
argsFound = new HashSet<Character>(); 
parseSchema(schema); 
parseArgumentStrings(Arrays.asList(args)); 
} 
private void parseSchema(String schema) throws ArgsException { 
for (String element : schema.split(",")) 
if (element.length() > 0) 


parseSchemaElement(element.trim()); 


private — void parseSchemaElement(String element) throws 
ArgsException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else if (elementTail.equals("[*]")) 
marshalers.put(elementId, new StringArrayArgumentMarshaler()); 
else 
throw new ArgsException(INVALID ARGUMENT FORMAT, 
elementId, elementTail); 
j 
private void — validateschemaElementId(char elementld) throws 
ArgsException 1 
if (!Character.isLetter(elementlId)) 
throw new  ArgsExceptionINVALID ARGUMENT NAME, 
elementld, null); 
j 
private void parseArgumentStrings(List<String> argsList) throws 


ArgsException 


for (currentArgument = argsList.listIterator(); 
currentArgument.hasNext();) 
{ 

String argString = currentArgument.next(); 

if (argString.startsWith("-")) { 
parseArgumentCharacters(argString.substring(1)); 

} else { 
currentArgument.previous(); 
break; 


} 
private void parseArgumentCharacters(String argChars) throws 
ArgsException { 
for (int i = 0; i < argChars.length(); i++) 
parseArgumentCharacter(argChars.charAt(i)); 
} 
private void parseArgumentCharacter(char argChar) throws 
ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) { 
throw | new  ArgsException(UNEXPECTED_ARGUMENT, 
argChar, null); 
} else { 
argsFound.add(argChar); 
try { 


m.set(currentArgument); 
} catch (ArgsException e) { 
e.setErrorArgumentId(argChar); 


throw e; 


} 
public boolean has(char arg) { 
return argsFound.contains(arg); 
} 
public int nextArgument() { 
return currentArgument.nextIndex(); 
} 
public boolean getBoolean(char arg) { 
return BooleanArgumentMarshaler.getValue(marshalers.get(arg)); 
} 
public String getString(char arg) { 
return StringArgumentMarshaler.getValue(marshalers.get(arg)); 
} 
public int getInt(char arg) { 
return IntegerArgumentMarshaler.getValue(marshalers.get(arg)); 
} 
public double getDouble(char arg) { 
return DoubleArgumentMarshaler.getV alue(marshalers.get(arg)); 
j 
public String[] getStringArray(char arg) 1 


return 


StringArrayArgumentMarshaler.getValue(marshalers.get(arg)); 
} 
} 
注意 ， 你 可 以 从 上 到 下 阅读 这 些 代 码 ， 不 用 跳 来 跳 去 ， 也 不 用 先 看 
后 面 的 部 分 。 唯 一 需要 先 看 的 是 ArgumentMarshaler 的 定义 ， 这 部 分 我 有 
意 省 略 了 。 仔 细 看 这 段 代 码 ， 你 应 该 能 理解 ArgumentMarshaler 接口 是 
什么 ， 其 派生 类 做 什么 。 下 面 我 将 问 你 展示 一 部 分 (如 代码 清单 14-3~ 
14-6 所 示 ) 。 
代码 清单 14-3 ArgumentMarshaler.java 
public interface ArgumentMarshaler { 
void set(Iterator<String> currentArgument) throws ArgsException; 
} 
代码 清单 14-4 BooleanArgumentMarshaler.java 
public class BooleanArgumentMarshaler implements 
ArgumentMarshaler { 
private boolean booleanValue = false; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
booleanValue = true; 
} 
public static boolean getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof BooleanArgumentMarshaler) 
return ((BooleanArgumentMarshaler) am).booleanValue; 
else 


return false; 


代码 清单 14-5 StringArgumentMarshaler.java 
import static 
com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 
public class StringArgumentMarshaler implements ArgumentMarshaler 
private String string Value = ""; 
public void  set(Iterator<String> currentArgument) throws 
ArgsException { 
try { 
stringValue = currentArgument.next(); 
} catch (NoSuchElementException e) { 
throw new ArgsException(MISSING_STRING); 


} 
public static String getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof StringArgumentMarshaler) 
return ((StringArgumentMarshaler) am).stringValue; 
else 


nn", 


return ""; 


j 

代码 清单 14-6 IntegerArgumentMarshaler.java 

import static 
com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 


public class IntegerArgumentMarshaler implements ArgumentMarshaler 


private int intValue = 0; 


public void set(Iterator<String> currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 
} catch (NoSuchElementException e) { 
throw new ArgsException(MISSING_INTEGER); 
} catch (NumberFormatException e) { 
throw new ArgsException(INVALID_INTEGER, parameter); 


} 
public static int getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof IntegerArgumentMarshaler) 
return ((IntegerArgumentMarshaler) am).intValue; 
else 


return 0; 


} 

ArgumentMarshaler 的 其 他 派生 类 以 同样 的 模式 处 理 double 和 String 
数组 ， 一 一 列 出 反而 阻碍 行文 。 你 可 以 练习 自己 实现 它们 。 

还 有 些 信息 可 能 会 困扰 你 : 错误 码 常 量 的 定义 。 这 些 是 在 
ArgsException 类 《代码 清单 14-7) 中 定义 的 。 

代码 清单 14-7 ArgsException.java 


import static 








com.objectmentor.utilities.args.ArgsException.ErrorCode.*; 


public class ArgsException extends Exception { 


private char errorArgumentld = '\0'; 
private String errorParameter = null; 
private ErrorCode errorCode = OK; 
public ArgsException() {} 
public ArgsException(String message) { super(message);} 
public ArgsException(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public ArgsException(ErrorCode errorCode, String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
} 
public ArgsException(ErrorCode errorCode, 
char errorArgumentlId, String errorParameter) 
{ 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentld; 


} 


public char getErrorArgumentId() { 


return errorArgumentld; 


public void setErrorArgumentId(char errorArgumentld) 1 


this.errorArgumentId = errorArgumentlId; 


public String getErrorParameter() { 


return errorParameter; 


} 


public void setErrorParameter(String errorParameter) { 
this.errorParameter = errorParameter; 
} 
public ErrorCode getErrorCode() { 
return errorCode; 
} 
public void setErrorCode(ErrorCode errorCode) { 
this.errorCode = errorCode: 
} 
public String errorMessage() { 
switch (errorCode) { 
case OK: 
return "TILT: Should not get here."; 
case UNEXPECTED_ARGUMENT: 
return String.format("Argument -%c unexpected.", 
errorArgumentld); 
case MISSING_STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentld); 
case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but was 
'9os'.", 
errorArgumentld, errorParameter); 
case MISSING_INTEGER: 
return String.format("Could not find integer parameter for -%c.", 


errorArgumentld); 


case INVALID DOUBLE: 
return String.format(" Argument -%c expects a double but was 
OS 
errorArgumentld, errorParameter); 
case MISSING_DOUBLE: 
return String.format("Could not find double parameter for -%c.", 
errorArgumentld); 
case INVALID_ARGUMENT_NAME: 
return String.format("'%c' is not a valid argument name.", 
errorArgumentld); 
case INVALID_ARGUMENT_FORMAT: 


return String.format("'%s' is not a valid argument format.", 


errorParameter); 
} 
return ""; 
} 
public enum ErrorCode { 
OK, INVALID_ARGUMENT_FORMAT, 


UNEXPECTED ARGUMENT, INVALID ARGUMENT NAME, 
MISSING STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE 
} 
为 了 充实 这 么 一 个 简单 概念 的 细节 ， 需 要 如 此 多 代码 ， 这 很 值得 注 
意 。 原 因 之 一 是 我 们 使 用 了 Java 这 种 踪 叫 型 语言 。 作 为 一 种 静态 类 型 语 
言 ， 需 要 大 量 语 句 才 能 满足 类 型 系统 的 要 求 。 在 Ruby、Python 或 
Smalltalk 等 语言 中 ， 程 序 会 短 很 多 [1]。 





请 再 次 阅读 这 段 代 码 。 特 别 留意 命名 方式 、 函 数 大 小 和 代码 格式 。 
如 采 你 是 经 验 丰富 的 程序 员 ， 可 能 会 对 风格 或 结构 有 着 这 样 或 那样 的 不 
同 观点 。 不 过 ， 和 希望 你 认为 这 段 程序 总 体 上 编写 展 好 ， 有 着 整洁 的 结 
构 。 

例如 ， 如 何 增加 新 参数 类 型 ， 如 日 期 或 复杂 数字 参数 。 其 实现 手段 
很 清楚 ， 而 且 只 需要 花 一 点 点 力气 即 可 。 简 言 之 ， 只 需要 从 
ArgumentMarshaler 派 生 一 个 新 类 ， 写 一 个 新 的 getXXX 疯 数 ， 在 
parseSchemaElement 函数 中 添加 一 个 新 的 case 语句 。 可 能 还 需要 添加 新 
的 ArgsException.Errorcode 和 新 错误 信息 。 

我 怎么 做 的 ? 

先 放松 一 下 神经 。 这 段 程序 并 非 从 一 开始 就 写成 现在 的 样子 。 更 重 
要 的 是 ， 我 也 没 指望 你 能 够 一 次 过 写 出 整洁 、 漂 亮 的 程序 。 如 果 说 我 们 
从 过 去 几 十 年 里 面 学 到 什么 东西 的 话 ， 那 就 是 编程 是 一 种 技艺 其 于 科学 
的 东西 。 要 编写 整洁 代码 ， 必 须 先 写 脐 脏 代 码 ， 然 后 再 清理 它 。 

你 应 该 不 会 对 此 感到 惊讶 。 我 们 在 小 学 就 学 过 这 条 真理 了 。 那 时 ， 
老师 (通常 是 徒劳 地 )〉 努力 让 我 们 写作 文 草稿。 他 们 告诉 我 们 ， 我 们 应 
该 先 写 草稿 ， 再 写 二 稿 ， 一 次 又 一 次 地 草 扎 ， 直 至 号 出 终 稿 。 他 们 尽力 
告诉 我 们 ， 写 出 好 作文 是 一 个 逐步 改进 的 过 程 。 

多 数 新 手 程序 员 《〈 就 像 多 数 小 学 生 一 样 ) 没有 特别 认真 地 遵循 这 个 
建议 。 他 们 相信 ， 首 要 任务 是 写 出 能 工作 的 程序 。 只 要 程序 “能 工作 ”， 
就 转移 到 下 一 个 任务 上 ， 而 那个 “能 工作 ”的 程序 就 留 在 了 最 后 那个 所 
谓 “ 能 工作 ”的 状态 。 多 数 老手 程序 员 都 知道 ， 这 是 一 种 自 毁 行为 。 























14.2 Args: 





代码 清单 14-8 展 示 了 Args 类 的 一 个 早期 版 本 。 它 “能 工作 ”， 但 却 很 
烂 。 
代码 清单 14-8 Args.java (初稿 ) 
import java.text.ParseException; 
import java.util.*; 
public class Args { 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 
private Map<Character, String> stringArgs = new 
HashMap<Character, String>(); 
private Map<Character, Integer> intArgs = new HashMap<Character, 
Integer>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgumentld = '\0'; 
private String errorParameter = "TILT"; 


private ErrorCode errorCode = ErrorCode.OK; 


private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID INTEGER, UNEXPECTED ARGUMENT 
public Args(String schema, String[] args) throws ParseException 1 
this.schema = schema; 
this.args = args; 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
retum true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
} 
return valid; 
j 
private boolean parseSchema() throws ParseException 1 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 


parseSchemaElement(trimmedElement); 


} 


return true; 


private void parseSchemaElement(String element) throws 
ParseException { 

char elementId = element.charAt(0); 

String elementTail = element.substring(1); 

validateSchemaElementId(elementId); 

if (isBooleanSchemaElement(elementTail)) 
parseBooleanSchemaElement(elementld); 

else if (isStringSchemaElement(elementTail)) 
parseStringSchemaElement(elementld); 

else if (isIntegerSchemaElement(elementTail)) { 
parseIntegerSchemaElement(elementId); 

} else { 
throw new ParseException 

(String.format("Argument: %c has invalid format: %s.", 


elementId,elementTail),0); 


j 
private void  validateSchemaElementId(char elementId) throws 
ParseException 1 
if (!Character.isLetter(elementId)) 1 
throw new ParseException( 


"Bad character:"+elementId+"in Args format: "+schema,0); 


} 
private void parseBooleanSchemaElement(char elementId) { 


booleanArgs.put(elementld, false); 


private void parseIntegerSchemaElement(char elementId) { 
intArgs.put(elementld, 0); 

} 

private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementld, ""); 

} 

private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 

} 

private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 

} 

private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 

} 

private boolean parseArguments() throws ArgsException { 


for (currentArgument = 0; currentArgument < args.length; 


currentArgument++) { 


String arg = args[currentArgument |; 
parseArgument(arg); 
} 
return true; 
j 
private void parseArgument(String arg) throws ArgsException 1 
if (arg.startsWith("-")) 


parseElements(arg); 


private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode = ErrorCode. UNEXPECTED ARGUMENT; 


valid = false; 


} 
private boolean setArgument(char argChar) throws ArgsException { 
if (isBooleanArg(argChar)) 
setBooleanArg(argChar, true); 
else if (isString Arg(argChar)) 
setString Arg(argChar); 
else if (isIntArg(argChar)) 
setIntArg(argChar); 
else 
return false; 
return true; 
} 
private boolean isIntArg(char argChar) {return 
intArgs.containsKey(argChar); } 
private void setIntArg(char argChar) throws ArgsException { 


currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.put(argChar, new Integer(parameter)); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
valid = false; 
errorArgumentld = argChar; 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID_INTEGER; 


throw new ArgsException(); 


} 
private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 
try { 
stringArgs.put(argChar, args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) 1 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
private boolean isStringArg(char argChar) { 
return stringArgs.containsKey(argChar); 
} 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
} 
private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING_STRING: 


return String.format("Could not find string parameter for - 
%c.", 
errorArgumentld); 
case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but 
was '%s'.", 
errorArgumentld, errorParameter); 
case MISSING_INTEGER: 
retum String.format("Could not find integer parameter for -%c.", 
errorArgumentld); 


WIT, 


return ""; 


private String unexpectedArgumentMessage() { 


} 


StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
} 
message.append(" unexpected."); 


return message.toString(); 


private boolean falseIfNull(Boolean b) { 


} 


return b != null && b; 


private int zeroIfNull(Integer i) { 


retum i -- null ?0: i; 


private String blankIfNull(String s) { 
return s == null ? "" : s; 
} 
public String getString(char arg) { 
return blankIfNull(stringArgs.get(arg)); 
j 
public int getInt(char arg) 1 
return zeroIfNull(intArgs.get(arg)); 
j 
public boolean getBoolean(char arg) 1 
return falseIfNull(booleanArgs.get(arg)); 
j 
public boolean has(char arg) 1 
return argsFound.contains(arg); 
j 
public boolean isValid() 1 


return valid; 





j 
private class ArgsException extends Exception 1 
j 
j 
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真 令 人 高 兴 ! ”如 果 你 这 么 想 ， 不 如 想 想 其 他 人 对 你 留置 在 草稿 形态 的 
代码 的 想法 吧 。 


实际 上 , “草稿 ”大概 会 是 你 对 这 上 段 代 人 码 的 最 高 评价 。 它 显然 还 需 打 
磨 。 实 体 变 量 的 数量 多 到 吓人 。 诸 如 TILT 之 类 奇怪 的 字符 串 ，HashSet 
和 TreeSets， 还 有 那些 try-catch-catch 代 人 码 块 ， 组 成 了 一 个 烂摊子 。 


我 不 想 写 出 一 个 烂摊子 。 我 也 一 直 想 保持 一 切 有 序 。 从 函数 和 变量 
命名 ， 以 及 程序 的 粗略 架构 中 ， 你 可 以 看 出 这 一 点 。 不 过 ， 显 然 我 没 能 


做 到 。 


混乱 是 逐渐 产生 的 。 更 早 的 版 本 并 不 如 此 及 脏 。 例 如 ， 代 码 清单 
14-9 展 示 了 一 个 早期 版 本 代码 ， 那 时 只 文 持 Boolean 参 数 。 
代码 清单 14-9 Args.java (只 支持 Boolean) 


package com.objectmentor.utilities.getopts; 


import java.util.*; 


public class Args { 


private String schema; 
private String[] args; 
private boolean valid; 


private Set<Character> unexpectedArguments 


TreeSet<Character>(); 


private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 
private int numberOfArguments = 0; 
public Args(String schema, String[] args) { 
this.schema = schema; 
this.args = args; 
valid = parse(); 
} 
public boolean isValid() { 
return valid; 
} 
private boolean parse() { 
if (schema.length() == 0 && args.length == 0) 


new 


retum true; 
parseSchema(); 
parseArguments(); 
return unexpectedArguments.size() == 0; 
} 
private boolean parseSchema() { 
for (String element : schema.split(",")) { 
parseSchemaElement(element); 
return true; 
} 
} 
private void parseSchemaElement(String element) { 
if (element.length() == 1) { 


parseBooleanSchemaElement(element); 


} 
private void parseBooleanSchemaElement(String element) { 
char c = element.charAt(0); 
if (Character.isLetter(c)) { 
booleanArgs.put(c, false); 


} 
private boolean parseArguments() { 
for (String arg : args) 
parseArgument(arg); 


return true; 


private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) { 
if (isBoolean(argChar)) { 
numberOfArguments++; 
setBooleanArg(argChar, true); 
} else 
unexpectedArguments.add(argChar); 
} 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
} 
private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
public int cardinality() { 
return numberOfArguments; 
} 
public String usage() { 
if (schema.length() > 0) 


return "-[" + schema + "]"; 


else 
return ""; 
} 
public String errorMessage() { 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage(); 
} else 
return ""; 
} 
private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
} 
message.append(" unexpected."); 
return message.toString(); 
} 
public boolean getBoolean(char arg) { 
return booleanArgs.get(arg); 


} 





} 

尽管 你 可 能 对 这 段 代码 很 不 满意 ， 其 实 它 并 非 如 此 之 烂 。 它 精练 、 
简单 ， 易 于 理解 。 然 而 ， 在 这 段 代码 中 很 容易 找到 后 面 烂摊子 的 根源 。 
很 清楚 能 看 到 小 问题 如 何 变 成 大 混乱 的 。 

注意 ， 后 来 的 混乱 代码 只 比 这 个 版 本 多 文 持 两 种 参数 类 型 ， String 
和 integer。 只 增加 两 种 参数 类 型 文 持 ， 束 对 代码 产生 了 如 此 巨大 的 负面 
影响 。 它 从 茶 种 可 维护 之 物 变 成 了 满 是 缺陷 的 东西 。 





我 逐步 添加 了 对 这 两 种 参数 类 型 的 文 持 。 首 先 ， 我 添加 对 String 参 
数 的 支持 ， 就 像 这 样 : 
代码 清单 14-10 Args.java (Boolean 和 String ) 
package com.objectmentor.utilities.getopts; 
import java.text.ParseException; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 
private Map<Character, String> stringArgs = 
new HashMap<Character, String>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgument = ^0'; 
enum ErrorCode { 
OK, MISSING_STRING} 
private ErrorCode errorCode = ErrorCode.OK; 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
this.args = args; 


valid = parse(); 


private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
parseArguments(); 
return valid; 


} 


private boolean parseSchema() throws ParseException { 


for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 


parseSchemaElement(trimmedElement); 


} 
return true; 
} 
private void —parseSchemaElement(String 
ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
parseBooleanSchemaElement(elementld); 
else if (isStringSchemaElement(elementTail)) 
parseStringSchemaElement(elementId); 


} 


private void validateSchemaElementId(char 


element) 


elementId) 


throws 


throws 


ParseException { 
if (!Character.isLetter(elementld)) { 
throw new ParseException( 


"Bad character:" + elementId + "in Args format: " + schema, 0); 


} 

private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementld, ""); 

} 

private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 

} 

private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 

} 

private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementld, false); 

} 


private boolean parseArguments() { 


for (currentArgument = 0; currentArgument < args.length; 
currentArgument++) 
{ 


String arg = args[currentArgument]; 
parseArgument(arg); 
} 


return true; 


private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 


valid = false; 


} 
private boolean setArgument(char argChar) { 
boolean set = true; 
if (isBoolean(argChar)) 
setBooleanArg(argChar, true); 
else if (isString(argChar)) 
setStringArg(argChar, ""); 
else 
set = false; 
return set; 
} 
private void setStringArg(char argChar, String s) { 


currentArgument++; 
try { 
stringArgs.put(argChar, args[currentArgument]); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgument = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


} 
private boolean isString(char argChar) { 
return stringArgs.containsKey(argChar); 
} 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
} 
private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 


uu, 


return ""; 


public String errorMessage() throws Exception { 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage(); 
} else 
switch (errorCode) { 
case MISSING_STRING: 


return String.format("Could not find string parameter for - 


%c.", 
errorArgument); 
case OK: 
throw new Exception("TILT: Should not get here."); 
} 
return ""; 


} 


private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 

message.append(c); 

} 
message.append(" unexpected."); 
return message.toString(); 

} 

public boolean getBoolean(char arg) { 
return falseIfNull(booleanArgs.get(arg)); 

} 

private boolean falseIfNull(Boolean b) { 


return b == null ? false : b; 


public String getString(char arg) { 
return blankIfNull(stringArgs.get(arg)); 
} 
private String blankIfNull(String s) { 
return s == null ? "" : s; 
j 
public boolean has(char arg) 1 
return argsFound.contains(arg); 
j 
public boolean isValid() 1 
return valid; 
j 
} 
你 可 以 看 到 ， 代 码 开 始 失去 控制 。 还 算 不 上 可 怕 ， 但 混乱 已 经 开始 
生长 。 已 经 出 现 了 一 堆 东 西 ， 不 过 还 没 烂 掉 。 增 加 对 整数 参数 类 型 的 文 
持 后 ， 那 堆 东西 就 真 的 变质 腐烂 了 。 





14.2.1 所 以 我 暂停 


还 有 至 少 两 种 参数 类 型 要 添加 ， 而 且 情形 一 定 会 更 加 糟糕 。 如 果 一 
味 亚 干 ， 大 概 也 能 让 它 工 作 ， 不 过 就 会 留 下 一 大 堆 要 调整 的 混乱 。 如 果 
希望 代码 结构 一 直 可 维护 ， 现 在 就 是 调整 的 时 机 了 。 

所 以 我 暂停 添加 特性 ， 开 始 重 构 。 由 于 刚 添 加 了 String 和 integer 参 
数 ， 我 知道 每 种 参数 类 型 都 需要 在 三 个 主要 位 置 增加 新 人 代码。 首先， 每 
种 参数 类 型 都 要 有 解析 其 范式 元 素 、 从 而 为 该 种 类 型 选择 HashMap 的 方 
法 。 其 次 ， 每 种 参数 类 型 都 需要 在 命令 行 字符 串 中 解析 ， 然 后 再 转换 为 








真实 类 型 。 最 后 ， 每 种 参数 类 型 都 需要 一 个 getXXX 方 法 ， 按 照 其 真实 
类 型 回调 用 者 返回 参数 值 。 

许多 种 不 同类 型 ， 类 似 的 方法 一 一 听 起 来 像 是 个 类 。 
ArgumentMarshaler 的 概念 就 是 这 样 产生 的 。 


14.2.2 渐进 


毁坏 程序 的 最 好 方法 之 一 就 是 以 改进 之 名 大 动 其 结构 。 有 些 程序 永 
远 不 能 从 这 种 所 谓 “ 改 进 ” 中 恢复 过 来 。 问 题 在 于 ， 很 难 让 程序 以 “ 改 
Xt"Z BIBI SALE 

为 了 避免 这 种 状况 发 生 ， 我 采用 了 测试 驱动 开发 的 规程 。 这 种 手法 
的 核心 原则 之 一 是 保持 系统 始终 能 运行 。 换 言 之 ， 采 用 TDD， 我 不 会 允 
许 做 出 破坏 系统 的 修改 。 每 次 修改 都 必须 保证 系统 能 像 以 前 一 样 工作 。 

我 需要 一 套 能 随 需 运行 、 人 确保 系统 行为 不 会 改动 的 自动 化 测试 。 在 
我 搞 出 那个 烂 挫 子 的 同时 ， 也 为 Args 类 创建 了 一 套 单元 测试 和 验收 测 
试 。 单 元 测试 用 Java 写 成 ， 采 用 JUnit 管 理 。 验 收 测试 用 FitNesse 以 wiki 
页 形式 写成 。 我 可 以 随时 运行 这 些 测 试 ， 如 果 测 试 通过 ， 就 能 打包 票 说 
系统 以 我 期 望 的 方式 工作 。 

于 是 我 开始 做 出 大 量 小 规模 修改 。 每 次 修改 都 将 系统 结构 回 
ArgumentMarshaler 概念 的 方向 推动 。 而 且 每 次 修改 后 ， 系 统 都 要 能 工 
作 。 第 一 个 修改 是 在 烂摊子 末尾 添加 ArgumentMarshaler 的 轮廓 。 

代码 清单 14-11 癌 Args.java 添 加 ArgumentMarshaler 


private class ArgumentMarshaler { 








private boolean booleanValue = false; 
public void setBoolean(boolean value) { 


booleanValue = value; 


public boolean getBoolean() {return booleanValue;} 

} 

private class BooleanArgumentMarshaler extends 
ArgumentMarshaler { 

} 

private class StringArgumentMarshaler extends ArgumentMarshaler { 

} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 


} 

显然 ， 这 什么 也 不 会 破坏 。 于 是 我 做 了 一 点 最 简单 的 、 破 坏 性 尽 可 
能 小 的 修改 。 我 修改 了 HashMap， 采 用 ArgumentMarshaler， 使 之 支持 
Boolean 参 数 。 

private Map<Character, ArgumentMarshaler> booleanArgs = 


new HashMap<Character, ArgumentMarshaler>(); 


这 个 修改 影响 到 少数 语句 ， 我 很 快 就 修正 了 。 


private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementId, new BooleanArgumentMarshaler()); 
} 

private void setBooleanArg(char argChar, boolean value) { 


booleanArgs.get(argChar).setBoolean(value); 
} 


public boolean getBoolean(char arg) { 


return falseIfNull(booleanArgs.get(arg).getBoolean()); 

} 

注意 ， 这 些 修 改正 是 在 我 之 前 提 到 的 那些 区 域 之 内 所 做 的 : 参数 类 
型 的 parse、set 和 get 操 作 。 不 幸 的 是 ， 即 便 修 改 如 此 细微 ， 有 些 测 试 还 
是 会 失败 。 仔 细 看 getBoolean， 可 以 看 到 如 果 用 y 去 调用 、 而 并 没有 y 这 
个 参数 ， 则 booleanArgs.get(y) 就 会 返回 null 值 ， 函 数 将 抛 出 一 个 
NullPointerException 异 常 。 函 数 falseIfNull 用 以 防止 这 种 状况 发 生 ， 但 我 
做 出 的 修改 却 导致 该 函数 无 所 作为 。 

渐进 主义 要 求 我 在 做 其 他 修改 之 前 迅速 修正 这 个 问题 。 修 正 并 不 费 
劲 。 我 只 是 把 对 null 值 的 检查 移 了 个 位 置 。 再 也 不 用 检测 bollean 是 否 大 
null， 而 是 检查 ArgumentMarshaler 是 否 为 null。 

首先 ， 我 移 除 了 getBoolean 函 数 中 的 falseIfNull 调 用 。 现 在 它 没什么 
用 了 ， 所 以 我 也 删 去 了 这 个 函数 。 测 试 还 是 以 同样 的 方式 失败 ， 所 以 我 
确定 没有 引入 新 的 错误 。 

public boolean getBoolean(char arg) { 





return booleanArgs.get(arg).getBoolean(); 
} 
下 一 步 ， 我 把 函数 拆 解 为 两 行 ， 并 把 ArgumentMarshaler 放 到 它 上 自己 
的 名 为 argumentMarshaler 的 变量 中 [21]。 我 不 在 意 变 量 名 太 长 ， 但 它 却 有 
点 哆 嗪 ， 把 函数 搞 得 文 离 破 碎 。 所 以 我 把 变量 名 缩短 为 am[N5]。 
public boolean getBoolean(char arg) { 





Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am.getBoolean(); 

} 

然后 再 放 入 检测 null 值 的 逻辑 。 

public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 


return am != null && am.getBoolean(); 


14.3 REB S 


添加 String 参 数 和 添加 boolean 参 数 非常 像 。 我 要 修改 HashMap， 让 
parse、set 和 get 函 数 能 工作 。 跟 着 就 是 按部就班 ， 但 我 似乎 该 把 所 有 的 
marshalling 〈 编 组 ) 实现 放 到 ArgumentMarshaler 基 类 而 不 是 派生 类 中 。 


private Map<Character, ArgumentMarshaler> stringArgs = 





new HashMap<Character, ArgumentMarshaler>(); 


private void parseStringSchemaElement(char elementId) { 


stringArgs.put(elementId, new StringArgumentMarshaler()); 


private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 
try 1 

stringArgs.get(argChar).setString(args[currentArgument]); 

} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 


return am == null ? "" : am.getString(); 


private class ArgumentMarshaler { 
private boolean booleanValue = false; 
private String stringValue; 
public void setBoolean(boolean value) { 
booleanValue = value; 
} 
public boolean getBoolean() { 
return booleanValue; 
} 
public void setString(String s) { 
stringValue = s; 
} 
public String getString() { 
return stringValue == null ? "" : stringValue; 
} 
} 
同样 ， 也 是 每 次 修改 一 个 地 方 ， 持 续 运 行 测试 。 如 果 测 斌 出错， 在 
做 下 一 个 修改 前 确保 通过 。 
现在 你 应 该 明白 我 的 意图 了 。 一 旦 我 将 当前 的 编组 行为 放 到 
ArgumentMarshaler 基 类 中 ， 就 会 开始 往 派生 类 推 入 该 行为 。 这 样 ， 在 我 
逐渐 修改 程序 的 形状 时 ， 还 能 保持 一 切 正 第。 
下 一 步 显而易见 ， 把 int 参 数 的 相关 功能 放 到 ArgumentMarshaler 里 








面 。 同 样 ， 也 是 照 方 抓 药 。 
private Map<Character, ArgumentMarshaler> intArgs = 


new HashMap<Character, ArgumentMarshaler>(); 


private void parseIntegerSchemaElement(char elementId) { 


intArgs.put(elementId, new IntegerArgumentMarshaler()); 


private void setIntArg(char argChar) throws ArgsException { 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.get(argChar).setInteger(Integer.parseInt(parameter)); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentld = argChar; 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
valid = false; 
errorArgumentld = argChar; 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw new ArgsException(); 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 


return am == null ? 0 : am.getInteger(); 


private class ArgumentMarshaler { 

private boolean booleanValue = false; 

private String string Value; 

private int integerValue; 

public void setBoolean(boolean value) { 
booleanValue = value; 

} 

public boolean getBoolean() { 
return booleanValue; 

} 

public void setString(String s) { 
stringValue = s; 

} 

public String getString() { 


return string Value == null ? "" : stringValue; 


public void setInteger(int 1) { 


integerValue = i; 


public int getInteger() { 


return integerValue; 


} 

当 所 有 的 编组 操作 都 放 到 了 ArgumentMarshaler®, RI ea RAE 
类 移植 功能 。 第 一 步 是 把 setBoolean 函 数 放 到 BooleanArgumentMarshaler 
中 ， 确 保 它 能 正确 调用 。 所 以 我 创建 了 一 个 抽象 的 set 方 法 。 

private abstract class ArgumentMarshaler { 

protected boolean booleanValue = false; 
private String string Value; 
private int integerValue; 
public void setBoolean(boolean value) { 
booleanValue = value; 
} 
public boolean getBoolean() { 
return booleanValue; 
} 
public void setString(String s) { 
string Value = s; 
} 
public String getString() { 
return string Value == null ? "" : stringValue; 
} 
public void setInteger(int i) { 
integerValue = i; 
} 
public int getInteger() { 


return integerValue; 


public abstract void set(String s); 
} 

然后 在 BooleanArgumentMarshaler 中 实现 set 方 法 。 

private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
public void set(String s) { 


booleanValue = true; 


} 
最 后 ， 通 过 调用 set， 蔡 换 对 setBoolean 的 调用 。 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.get(argChar).set("true"); 
} 
测试 仍然 全 部 通过 。 因 为 这 次 修改 导致 set 函 数 放 到 了 
aa 里 面 ， 我 就 从 ArgumentMarshaler 基 类 删除 了 
setBoolean 方 法 。 
注意 ， 抽 象 函数 set 有 一 个 String 参 数 ， 但 其 在 
BooleanArgumentMarshaler 中 的 实现 却 没有 使 用 这 个 参数 。 之 所 以 在 这 
里 放 个 参数 ， 是 因为 我 知道 StringArgumentMarshaler 和 
IntegerArgumentMarshaler 可 能 会 使 用 它 。 
跟着 ， 我 打算 把 get 方 法 放 到 BooleanArgumentMarshaler 中 。 这 有 点 
难看 ， 因 为 返回 类 型 必须 是 Object， 且 在 这 里 需要 转换 为 Boolean 值 。 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am != null && (Boolean)am.get(); 
} 
为 了 编译 通过 ， 我 把 get 函 数 加 到 ArgumentMarshaler 中 。 


private abstract class ArgumentMarshaler { 


public Object get() { 


return null; 


} 





这 样 一 来 ， 虽 然 可 以 编译 ， 但 却 无 法 通过 测试 。 只 要 将 get 修改 为 
抽象 方法 ， 并 在 BooleanArgumentMarshaler 中 实现 ， 就 能 重新 通过 测 


试 。 
private abstract class ArgumentMarshaler { 


protected boolean booleanValue = false; 


public abstract Object get(); 
} 
private class BooleanArgumentMarshaler 
ArgumentMarshaler { 
public void set(String s) { 
booleanValue = true; 
} 
public Object get() { 


return booleanValue; 


} 


extends 


测试 又 通过 了 。get 和 set 方 法 都 已 部 署 到 BooleanArgumentMarshaler 
中 ! 这 样 我 就 可 以 从 ArgumentMarshaler 里 面 移 除 旧 的 getBoolean 函 数 ， 
把 受 保 护 的 booleanValue 变 量 向 下 移动 到 BooleanArgumentMarshaler， 并 





将 其 设置 为 private。 


对 于 String 也 照 此 办 理 。 我 修改 了 set 和 get 的 部 敬 方 式 ， 删 除 无 用 的 


函数 ， 并 移动 了 变量 。 

private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 
try { 

stringArgs.get(argChar).set(args[currentArgument ]); 

) catch (ArrayIndexOutOfBoundsException e) 1 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 


public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 


return am == null ? "" : (String) am.get(); 


private abstract class ArgumentMarshaler { 

private int integerValue; 

public void setInteger(int i) { 
integerValue = i; 

} 

public int getInteger() { 
return integerValue; 

} 

public abstract void set(String s); 


public abstract Object get(); 
} 
private class BooleanArgumentMarshaler extends ArgumentMarshaler { 
private boolean booleanValue = false; 
public void set(String s) { 
booleanValue = true; 
} 
public Object get() { 


return booleanValue; 


} 

private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 

public void set(String s) { 
stringValue = s; 

} 

public Object get() { 


return stringValue; 


} 
private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
public void set(String s) { 
} 
public Object get() { 
return null; 


} 


} 

最 后 ， 我 为 integer 类 型 参数 重复 这 个 过 程 。 这 稍稍 复杂 一 点 ， 因 为 
integer 需要 和 解析， 而 parse 操作 会 抛 出 异常 。 不 过 结果 会 更 好 ， 因 为 
NumberFormatException 的 概念 在 IntegerArgumentMarshaler 中 隐藏 了 。 

private boolean isIntArg(char argChar) {return 
intArgs.containsKey(argChar);} 

private void setIntArg(char argChar) throws ArgsException { 

currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.get(argChar).set(parameter); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


private void setBooleanArg(char argChar) { 


try { 
booleanArgs.get(argChar).set("true"); 
} catch (ArgsException e) { 


} 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 


return am == null ? 0 : (Integer) am.get(); 


private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 


public abstract Object get(); 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0; 
public void set(String s) throws ArgsException { 
try { 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) { 
throw new ArgsException(); 


} 


public Object get() { 


return intValue; 


} 

测试 当然 继续 通过 。 下 一 步 ， 我 要 删 掉 算 法 顶端 的 三 种 不 同 Map。 
这 样 ， 整 个 系统 就 变 得 更 通用 了 。 不 过 ， 只 是 删除 它们 却 无 法 达到 目 
的 ， 因 为 那样 会 破坏 系统 。 反 之 ， 我 为 ArgumentMarshaler 轩 加 一 个 新 的 
Map， 然 后 再 逐个 修改 那些 方法 ， 让 方法 调用 这 个 新 Map。 

public class Args { 





private Map<Character, ArgumentMarshaler> booleanArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> stringArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


private void parseBooleanSchemaElement(char elementId) { 
ArgumentMarshalerm = new BooleanArgumentMarshaler(); 
booleanArgs.put(elementId, m); 
marshalers.put(elementId, m); 

} 

private void parseIntegerSchemaElement(char elementId) { 
ArgumentMarshaler m = new IntegerArgumentMarshaler(); 
intArgs.put(elementId, m); 


marshalers.put(elementId, m); 


private void parseStringSchemaElement(char elementId) { 
ArgumentMarshaler m = new StringArgumentMarshaler(); 
stringArgs.put(elementId,m); 
marshalers.put(elementId, m); 
} 
当然 ， 测 试 还 是 通过 了 。 接 着 ， 我 把 isBooleanArg: 
private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
修改 成 这 样 : 
private boolean isBooleanArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof BooleanArgumentMarshaler; 
} 
测试 仍然 通过 。 于 是 我 修改 了 一 下 isIntArg 和 isStringArg。 
private boolean isIntArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof IntegerArgumentMarshaler; 
} 
private boolean isStringArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof StringArgumentMarshaler; 
} 
测试 继续 通过 。 我 跟着 消除 了 对 marshaler.get 的 重复 调用 : 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 


if (isBooleanArg(m)) 


setBooleanArg(argChar); 
else if (isStringArg(m)) 
setStringArg(argChar); 
else if (isIntArg(m)) 
setIntArg(argChar); 
else 
return false; 
return true; 
} 
private boolean isIntArg(ArgumentMarshaler m) { 
return m instanceof IntegerArgumentMarshaler; 
} 
private boolean isStringArg(ArgumentMarshaler m) { 
return m instanceof StringArgumentMarshaler; 
} 
private boolean isBooleanArg(ArgumentMarshaler m) { 
return m instanceof BooleanArgumentMarshaler; 
} 
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private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(argChar); 
else if (m instanceof String ArgumentMarshaler) 
setString Arg(argChar); 
else if (m instanceof IntegerArgumentMarshaler) 


setIntArg(argChar); 


else 
retum false; 
retum true; 
} 
下 一 步 ， 我 开始 在 set 函 数 中 使 用 marshaler 映 射 ， 停 止 使 用 另外 三 个 
映射 映射 。 从 boolean 开 始 : 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(argChar); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(argChar); 
else 
retum false; 


return true; 


private void setBooleanArg(ArgumentMarshaler m) { 

try { 

m.set("true"); // was: booleanArgs.get(argChar).set("true"); 

} catch (ArgsException e) { 

} 
} 
测试 通过 ， 于 是 我 如 法 炮制 String 和 Integer 人 参数 。 这 样 我 就 能 把 有 

些 丑 陋 的 异常 管理 代码 整合 到 setArgument 疯 数 中 。 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
else 
return false; 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
return true; 
} 
private void setIntArg(ArgumentMarshaler m) throws ArgsException { 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
m.set(parameter); 
} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 


throw new ArgsException(); 


} catch (ArgsException e) { 
errorParameter = parameter; 


errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


} 


private void setStringArg(ArgumentMarshaler m) throws ArgsException 


currentArgument++; 

try { 
m.set(args[currentArgument]); 

} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
离 彻底 删除 那 3 个 旧 映 射 的 时 机 越 来 越 近 了 。 首 先 ， 我 需要 修改 
getBoolean 函 数 : 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am != null && (Boolean) am.get(); 
} 
修改 成 这 样 : 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 


boolean b = false; 


try { 


b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) { 


b = false; 
} 
return b; 
} 


最 后 这 个 修改 可 能 令 人 吃惊 。 为 什么 我 会 突然 决定 对 付 
ClassCastException? 原因 是 我 有 一 组 单元 测试 ， 还 有 用 FitNesse 编 写 的 
一 组 验收 测试 。FitNesse 测 试 确认 ， 如 果 用 非 布尔 值 参 数 调用 
getBoolean， 应 该 返回 false。 可 单元 测试 的 结果 不 是 这 样 。 而 到 此 时 为 
止 ， 我 一 直 只 调用 单元 测试 [3]。 

这 次 修改 把 另 一 个 对 boolean 映 射 的 使 用 抽 离 了 : 

private void parseBooleanSchemaElement(char elementId) { 


ArgumentMarshaler m = new BooleanArgumentMarshaler(); 


. Lj , 


marshalers.put(elementId, m); 
j 
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public class Args 1 


——private—Map«Charaeter, —ÀArgumentMarshaler» —booleanArgs—— 
new—HashMap«Characeter;,——ÀArgumentMarshaler»-(-- 
private Map<Character, ArgumentMarshaler> stringArgs = 
new HashMap<Character, ArgumentMarshaler>(); 


private Map<Character, ArgumentMarshaler> intArgs = 


new HashMap<Character, ArgumentMarshaler>(); 
private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


接 下 来 ， 我 用 同样 的 手法 处 理 String 和 Integer 参 数 ， 对 boolean 参 数 
做 了 一 点 清理 工作 。 

private void parseBooleanSchemaElement(char elementId) { 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 

} 

private void parseIntegerSchemaElement(char elementId) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 

} 

private void parseStringSchemaElement(char elementId) 1 


marshalers.put(elementId, new StringArgumentMarshaler()); 


public String getString(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) { 
return ""; 
} 
} 
public int getInt(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 


try { 


return am == null ? 0 : (Integer) am.get(); 
} catch (Exception e) { 

return 0; 
} 
} 


public class Args { 


private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 





接着 ， 由 于 那些 parse 方 法 没有 太 多 事 可 做 ， 我 对 它们 进行 了 内 联 修 
改 : 
private void parseSchemaFlement(String element) throws 
ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new 
BooleanArgumentMarshaler()); 


else if (isStringSchemaElement(elementTail)) 


marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
} else { 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 
elementTail), 0); 
} 
} 
行 了 ， 下 面 来 看 看 全 景 吧 。 代 码 清 单 14-12 展 示 了 Args 类 的 现状 。 
代码 清单 14-12 Args.java (首次 重 构 后 ) 
package com.objectmentor.utilities.getopts; 
import java.text.ParseException; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgumentld = '\0'; 
private String errorParameter = "TILT"; 


private ErrorCode errorCode = ErrorCode.OK; 


private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT} 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
this.args = args; 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
retum true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
} 
return valid; 
j 
private boolean parseSchema() throws ParseException 1 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 


parseSchemaElement(trimmedElement); 


} 


return true; 


private void parseSchemaElement(String element) throws 
ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (isStringSchemaElement(elementTail)) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
} else { 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 
elementTail), 0); 
} 
} 
private void validateSchemaElementld(char elementId) throws 
ParseException { 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 
"Bad character:" + elementId + "in Args format: " + schema, 
0); 
} 
} 
private boolean isStringSchemaElement(String elementTail) { 


return elementTail.equals("*"); 


} 


private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 

} 

private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 

} 

private boolean parseArguments() throws ArgsException { 

for (currentArgument=0; currentArgument<args.length; 

currentArgument++) { 

String arg = args[currentArgument |; 
parseArgument(arg); 

j 

return true; 


} 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 


else { 


unexpectedArguments.add(argChar); 
errorCode = ErrorCode. UNEXPECTED ARGUMENT; 


valid - false; 


j 
private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m = marshalers.get(argChar); 
try 1 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
else 
return false; 
} catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
retum true; 
} 
private void setIntArg(ArgumentMarshaler m) throws ArgsException { 
currentArgument++; 
String parameter = null; 


try { 


parameter = args[currentArgument]; 
m.set(parameter); 

} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 

} catch (ArgsException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


} 


private void setStringArg(ArgumentMarshaler m) throws ArgsException 


currentArgument++; 

try { 
m.set(args[currentArgument]); 

} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
private void setBooleanArg(ArgumentMarshaler m) { 
try { 
m.set("true"); 
} catch (ArgsException e) { 
} 


public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING_STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentld); 
case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but was 
OS. 3 
errorArgumentld, errorParameter); 
case MISSING_INTEGER: 
return String.format("Could not find integer parameter for -%c.", 
errorArgumentld); 
} 


return ""; 


} 
private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer("Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
} 
message.append(" unexpected."); 
return message.toString(); 
} 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 
try { 
b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) { 
b = false; 
} 
return b; 
} 
public String getString(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) { 


n", 


return ""; 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Integer) am.get(); 
} catch (Exception e) { 


return 0; 


} 
public boolean has(char arg) { 
return argsFound.contains(arg); 
} 
public boolean isValid() { 
return valid; 
} 
private class ArgsException extends Exception { 
} 
private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 
} 
private class BooleanArgumentMarshaler 
ArgumentMarshaler { 
private boolean booleanValue = false; 
public void set(String s) { 
booleanValue = true; 
} 
public Object get() { 


extends 


return booleanValue; 


} 

private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 

public void set(String s) { 
stringValue = s; 

} 

public Object get() { 


return string Value; 


} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 


private int intValue = 0; 
public void set(String s) throws ArgsException { 
try { 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) { 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


功夫 费 尽 ， 还 是 有 点 失望 。 程 序 结构 好 了 一 点 ， 但 在 代码 顶端 还 是 
有 那 一 堆 变 量 ， 在 setArgument 里 面 还 是 有 那么 娩 怖 的 类 型 转换 操作 ;， 而 
且 那 些 set 函 数 真 的 很 丑陋 。 就 列 提 那些 错误 处 理 操作 了 。 前 头 要 做 的 事 
还 很 多 。 

我 真是 想 删 挥 setArgument 里 面 那些 类 型 转换 操作 [G23]。 我 想 要 
setArgument 只 简单 地 调用 ArgumentMarshaler.set。 这 意味 着 我 需要 将 
setIntArg、setStringArg 和 setBooleanArg 推 到 合适 的 ArgumentMarshaler 派 
生 类 里 面 。 不 过 这 有 个 问题 。 

仔细 看 setIntArg， 你 会 发 现 ， 它 使 用 了 两 个 实体 变量 : args 和 
currentArg。 为 了 把 setIntArg 移 到 BooleanARgumentMarshaler 里 面 ， 我 得 
把 这 两 个 变量 都 作为 函数 参数 传递 过 去 。 那 种 做 法 太 烂 了 [FE1]。 我 只 想 
传递 一 个 参数 。 笠 和 运 的 是 ， 有 个 简单 的 解决 方法 。 可 以 把 args 数 组 转换 
为 一 个 list， 并 向 set 函 数 传递 一 个 Iterator。 这 花 了 我 10 步 功夫 ， 每 次 都 
通过 了 测试 。 不 过 我 只 向 你 展示 结果 。 你 应 该 能 看 出 每 个 小 修改 步骤 。 

public class Args { 





private String schema; 

private boolean valid = true; 

private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 

private Map<Character, ArgumentMarshaler> marshalers = 

new HashMap<Character, ArgumentMarshaler>(); 

private Set<Character> argsFound = new HashSet<Character>(); 

private Iterator<String> currentArgument; 

private char errorArgumentld = '\0'; 


private String errorParameter = "TILT"; 


private ErrorCode errorCode = ErrorCode.OK; 
private List<String> argsList; 
private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT} 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && argsList.size() == 0) 
retum true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
} 
return valid; 
} 
private boolean parseArguments() throws ArgsException { 
for (currentArgument = 
argsList.iterator(); currentArgument.hasNext();) { 
String arg = currentArgument.next(); 


parseArgument(arg); 


retun true; 


} 


private void setIntArg(ArgumentMarshaler m) throws ArgsException { 

String parameter = null; 

try { 
parameter = currentArgument.next(); 
m.set(parameter); 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 

} catch (ArgsException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


} 


private void setStringArg(ArgumentMarshaler m) throws ArgsException 


try { 
m.set(currentArgument.next()); 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


~ 


是 这 些 简单 的 修改 让 测试 保持 通过 。 现 在 我 们 可 以 开始 把 set 函数 


移植 到 合适 的 派生 类 中 了 。 第 一 步 ， 我 要 在 setArgument 中 做 以 下 修改 : 
private boolean i argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
return false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 


setIntArg(m); 


— —eise 
return false; 


} catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
return true; 
} 
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要 把 错误 条 件 抽 离 。 
现在 可 以 开始 移动 set 函数 了 。setBooleanArg 函数 很 小 ， 束 从 它 开 
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private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
retum false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m, currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
retum true; 


} 


private void setBooleanArg(ArgumentMarshaler m, 
Iterator<String> currentArgument) 


throws ArgsException { 


try—t 


m.set("true"); 


eateh_fArgskxeception—e}—_t 


一 一 


} 

我 们 不 是 刚 把 那个 异常 处 理 放 进去 吗 ? 放 进 拿 出 是 重 构 过 程 中 常见 
的 事 。 小 步 幅 和 保持 测试 通过 ， 意 味 着 你 会 不 断 移动 各 种 东西 。 重 构 有 
点 像 是 解 魔方 。 需 要 经 过 许多 小 步骤 ， 才 能 达到 较 大 目标 。 每 一 步 都 是 
下 一 步 的 基础 。 

为 什么 要 在 setBooleanArg 根本 不 需要 的 情况 下 同 其 传递 ”iterator 
呢 ?” 因 为 setIntArg 和 和 setStringArg 需 要 ! 还 因为 我 打算 通过 
ArgumentMarshaler 中 的 抽象 方法 部 车 这 三 个 函数 ， 雷 要 将 其 传递 给 
setBooleanArg. 

WifEsetBooleanArgzz H] | . UH ArgumentMarshaler" fj set el 
数 ， 我 们 可 以 直接 调用 它 。 是 时 候 打 造 那个 函数 了 ! 第 一 步 ， 在 
ArgumentMarshaler 中 添加 抽象 方法 。 


private abstract class ArgumentMarshaler { 





public abstract void set(Iterator<String> currentArgument) 
throws ArgsException; 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 
} 
当然 ， 这 会 影响 到 所 有 派生 类 。 上 所以， 要 逐个 实现 新 方法 。 


private class BooleanArgumentMarshaler extends ArgumentMarshaler { 





private boolean booleanValue = false; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 


booleanValue = true; 


public void set(String s) { 


— —booleanValue—-—true;- 


public Object get() ( 


return booleanValue; 


} 

private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 
public void set(Iterator<String> currentArgument) throws 

ArgsException { 

} 

public void set(String s) { 
string Value = s; 

} 

public Object get() { 


return string Value; 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 


private int intValue = 0; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 


} 
public void set(String s) throws ArgsException { 


try { 
intValue = Integer. parseInt(s); 
} catch (NumberFormatException e) { 


throw new ArgsException(); 


} 
public Object get() { 
return intValue; 
} 
} 
现在 可 以 删除 setBooleanArg 了 ! 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
return false; 
try 1 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
} catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 


throw e; 


retum true; 
} 
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面 了 ! 
现在 就 能 对 String 和 Integer 参 数 的 处 理 做 同样 的 修改 。 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
retum false; 
try { 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof IntegerArgumentMarshaler) 
m.set(currentArgument); 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
retum true; 


low 

private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 

public void  set(Iterator<String> currentArgument) throws 


ArgsException { 


try { 
stringValue = currentArgument.next(); 

} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 

public void set(String s) { 
} 

public Object get() { 


return string Value; 


} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0; 
public void  set(Iterator<String> currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
set(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID_INTEGER; 


throw e; 


} 
public void set(String s) throws ArgsException { 
try { 
intValue = Integer. parseInt(s); 
} catch (NumberFormatException e) { 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 
最 后 一 击 : 可 以 移 除 类 型 转换 了 ! ATA! 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
retum false; 
try { 
m.set(currentArgument); 
return true; 
} catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 


throw e; 


} 
现在 可 以 删 掉 IntegerArgumentMarshaler 中 那些 过 时 的 函数 ， 做 一 下 
清理 了 。 
private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
String 
parameter = null; 
try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw new ArgsException(); 


public Object get() { 


return intValue; 


} 
还 可 以 把 ArgumentMarshaler 修 改 为 接口 。 


private interface ArgumentMarshaler { 


void set(Iterator<String> currentArgument) throws ArgsException; 
Object get(); 
} 
现在 来 看 看 往 这 个 结构 中 添加 新 的 参数 类 型 有 多 容易 。 只 需要 做 少 
量 修 改 ， 而 且 修 改 是 被 隔离 的 。 前 先 ， 增 加 一 个 新 的 测试 用 例 ， 检 测 
double 参 数 是 否 正 常 工作 。 
public void testSimpleDoublePresent() throws Exception { 
Args args = new Args("x##", new String[] {"-x","42.3"}); 
assert True(args.is Valid()); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 
} 
然后 清理 范式 解析 代码 ， 为 double 参 数 类 型 添加 朵 监测 。 
private void parseSchemaElement(String element) throws 
ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 


marshalers.put(elementId, new DoubleArgumentMarshaler()); 


else 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 


elementTail), 0); 


} 
下 一 步 ， 编 写 DoubleArgumentMarshaler 类 。 
private Class DoubleArgumentMarshaler implements 


ArgumentMarshaler { 
private double doubleValue = 0; 
public void  set(Iterator<String> currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
doubleValue = Double.parseDouble(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_DOUBLE; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID_DOUBLE; 
throw new ArgsException(); 
} 
} 
public Object get() { 


return doubleValue; 


然后 就 得 添加 一 个 新 的 ErrorCode: 

private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 

INVALID_INTEGER, UNEXPECTED_ARGUMENT, 

MISSING_DOUBLE, INVALID_DOUBLE} 

还 需要 一 个 getDouble 函 数 : 

public double getDouble(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 

return am == null ? 0 : (Double) am.get(); 

} catch (Exception e) { 


return 0.0; 


} 
全 部 测试 都 通过 了 ! 完全 无 痛 。 再 来 确保 全 部 错误 处 理 代码 正确 工 
作 。 下 一 个 测试 用 例 用 来 检测 在 向 棒 参 数 传递 一 个 不 可 解析 的 字符 串 时 
是 否 会 返回 错误 。 
public void testInvalidDouble() throws Exception { 
Args args = new Args("x##", new String[] {"-x","Forty two"}); 
assertFalse(args.isValid()); 
assertEquals(0, args.cardinality()); 
assertFalse(args.has('x')); 
assertEquals(0, args.getInt('x')); 
assertEquals("Argument -x expects a double but was 'Forty two'.", 


args.errorMessage()); 


public String errorMessage() throws Exception { 


switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING_STRING: 
return String.format("Could not find string parameter for - 
%c.", 
errorArgumentld); 
case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but 
was '%s'.", 
errorArgumentld, errorParameter); 
case MISSING_INTEGER: 
return String.format("Could not find integer parameter for - 
%c.", 
errorArgumentld); 
case INVALID_DOUBLE: 
return String.format(" Argument -%c expects a double 
but was '%s'.", 
errorArgumentId, errorParameter); 
case MISSING DOUBLE: 
return String.format(" Could not find double parameter 
for -%c.", 


errorArgumentlId); 


i 
return ""; 
j 
测试 通过 。 下 一 个 测试 确保 我 们 正确 检测 到 遗漏 的 double 参 数 。 
public void testMissingDouble() throws Exception { 
Args args = new Args("x##", new String[]{"-x"}); 
assertFalse(args.isValid()); 
assertEquals(0, args.cardinality()); 
assertFalse(args.has('x')); 
assertEquals(0.0, args.getDouble('x'), 0.01); 
assertEquals(" Could not find double parameter for -x.", 
args.errorMessage()); 
} 
测试 如 期 通过 。 我 们 只 是 为 了 保持 一 切 完整 而 编写 这 个 测试 。 
异常 代码 很 丑陋 ， 不 该 在 Args 类 中 存在 。 我 们 也 抛 出 
ParseException， 但 那 并 不 真 的 属于 我 们 自己 。 那 束 把 所 有 异常 都 窄 到 
ArgsException 类 中 ， 并 将 其 移 到 它 自 己 的 模块 里 面 。 
public class ArgsException extends Exception { 
private char errorArgumentId = '\0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
public ArgsException() {} 
public ArgsException(String message) {super(message);} 
public enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT, 
MISSING_DOUBLE, INVALID_DOUBLE} 


} 


public class Args { 


private char errorArgumentld = '\0'; 

private String errorParameter = "TILT"; 

private ArgsException.ErrorCode errorCode 

ArgsException.ErrorCode.OK; 

private List<String> argsList; 

public Args(String schema, String[] args) throws ArgsException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 

} 

private boolean parse() throws ArgsException { 
if (schema.length() == 0 && argsList.size() == 0) 

return true; 
parseSchema(); 
try { 
parseArguments(); 

} catch (ArgsException e) { 
} 
return valid; 

} 


private boolean parseSchema() throws ArgsException { 


private void parseSchemaElement(String element) throws 


ArgsException { 


else 
throw new ArgsException( 
String.format("Argument: %c has invalid format: %s.", 
elementId,elementTail)); 
j 
private void  validateschemaElementId(char elementId) throws 
ArgsException 1 
if (!Character.isLetter(elementId)) 1 
throw new ArgsException( 


"Bad character:" + elementId + "in Args format: " + schema); 


private void parseElement(char argChar) throws ArgsException 1 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode = 
ArgsException.ErrorCode. UNEXPECTED ARGUMENT; 


valid = false; 


private class StringArgumentMarshaler implements ArgumentMarshaler 
private String stringValue = ""; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
try { 
string Value = currentArgument.next(); 
} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
public Object get() { 


return string Value; 


} 
private class IntegerArgumentMarshaler implements 
ArgumentMarshaler { 
private int intValue = 0; 
public void set(Iterator<String> ^ currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode.MISSING_INTEGER; 


throw new ArgsException(); 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ArgsException.ErrorCode.INVALID_INTEGER; 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 
private class DoubleArgumentMarshaler implements 
ArgumentMarshaler { 
private double doubleValue = 0; 
public void  set(Iterator<String> currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
doubleValue = Double.parseDouble(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode.MISSING_DOUBLE; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ArgsException.ErrorCode.INVALID_DOUBLE; 


throw new ArgsException(); 


} 
public Object get() { 


return doubleValue; 


} 

很 好 。 现 在 ，Args 抛 出 的 唯一 一 个 异常 是 ArgsException。 把 
ArgsException 移 到 它 自己 的 模块 中 ， 意 味 着 我 们 能 把 大 量 杂 七 杂 八 的 错 
误 文 持 代 码 从 Args 模 块 转移 到 这 个 模块 。 

现在 我 们 完全 把 异常 和 错误 代码 从 Args 模 块 中 隅 离 出 来 了 。《 如 代 
码 清 单 14-13 一 16 所 示 。) 为 达到 这 一 目标 ， 大 概 做 了 30 次 小 修改 ， 
次 修改 部 保持 测试 通过 。 

代码 清单 14-13 ArgsTest.java 

package com.objectmentor.utilities.args; 

import junit.framework.TestCase; 

public class ArgsTest extends TestCase { 

public void — testCreateWithNoSchemaOrArguments() throws 
Exception { 
Args args = new Args("", new String[0]); 
assertEquals(0, args.cardinality()); 
} 
public void testWithNoSchemaButWithOneArgument() throws 
Exception { 
try { 
new Args("", new String[]{"-x"}); 
fail(); 


} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode. UNEXPECTED ARGU?! 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
public void testWithNoSchemaButWithMultipleArguments() throws 
Exception { 
try { 
new Args( 
fail(); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode. UNEXPECTED_ARGUI 
e.getErrorCode()); 


mu 


i new String[]{"-x", "-y"}); 


assertEquals('x', e.getErrorArgumentId()); 


} 
public void testNonLetterSchema() throws Exception { 
try { 
new Args("*", new String[]{}); 
fail("Args constructor should have thrown exception"); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.INVALID_ARGUMENT_1 
e.getErrorCode()); 
assertEquals('*', e.getErrorArgumentlId()); 


public void testInvalidArgumentFormat() throws Exception { 
try { 
new Args("f~", new String[]{}); 
fail("Args constructor should have throws exception"); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.INVALID_FORMAT, 
e.getErrorCode()); 
assertEquals('f', e.getErrorArgumentId()); 
j 
j 
public void testSimpleBooleanPresent() throws Exception 1 
Args args = new Args("x", new String[]{"-x"}); 
assertEquals(1, args.cardinality()); 
assertEquals(true, args.getBoolean('x')); 
} 
public void testSimpleStringPresent() throws Exception { 
Args args = new Args("x*", new String[]{"-x", "param"}); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals("param", args.getString('x')); 
} 
public void testMissingStringArgument() throws Exception { 
try { 
new Args("x*", new String[]{"-x"}); 
failQ; 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.MISSING_STRING, 


e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentld()); 


} 
public void testSpacesInFormat() throws Exception { 
Args args = new Args("x, y", new String[]{"-xy"}); 
assertEquals(2, args.cardinality()); 
assert True(args.has('x')); 
assert True(args.has(‘y’')); 
} 
public void testSimpleIntPresent() throws Exception { 
Args args = new Args("x#", new String[]{"-x", "42"}); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(42, args.getInt('x')); 
} 
public void testInvalidInteger() throws Exception { 
try { 
new Args("x#", new String[]{"-x", "Forty two"}); 
failQ; 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.INVALID_INTEGER, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


assertEquals("Forty two", e.getErrorParameter()); 


public void testMissingInteger() throws Exception { 
try { 
new Args("x#", new String[]{"-x"}); 
fail(); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.MISSING_INTEGER, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
public void testSimpleDoublePresent() throws Exception { 
Args args = new Args("x##", new String[]{"-x", "42.3"}); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 
} 
public void testInvalidDouble() throws Exception { 
try { 
new Args("x##", new String[]{"-x", "Forty two"}); 
fail(); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.INVALID DOUBLE, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


assertEquals("Forty two", e.getErrorParameter()); 


public void testMissingDouble() throws Exception { 
try { 
new Args("x##", new String[]{"-x"}); 
fail(); 
} catch (ArgsException e) { 
assertEquals(ArgsException.ErrorCode.MISSING_DOUBLE, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
代码 清单 14-14 ArgsExceptionTest.java 
public class ArgsExceptionTest extends TestCase { 
public void testUnexpectedMessage() throws Exception { 
ArgsException e = 
new 
ArgsException(ArgsException.ErrorCode.UNEXPECTED_ARGUME 
'x', null); 
assertEquals("Argument -x unexpected.", e.errorMessage()); 
} 
public void testMissingStringMessage() throws Exception { 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode.MISSING_STRING, 
'x', null); 
assertEquals("Could not find string parameter for -x.", 
e.errorMessage()); 


} 


public void testInvalidIntegerMessage() throws Exception { 
ArgsException e = 
new 
ArgsException(ArgsException.ErrorCode.INVALID_INTEGER, 
'x', "Forty two"); 


assertEquals(" Argument -x expects an integer but was ‘Forty 


e.errorMessage()); 


public void testMissingIntegerMessage() throws Exception 1 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode.MISSING_INTEGER, 
'x', null); 
assertEquals("Could not find integer parameter for -x.", 
e.errorMessage()); 
} 
public void testInvalidDoubleMessage() throws Exception { 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode.INVALID_DOUBLE, 
'x', "Forty two"); 


assertEquals(" Argument -x expects a double but was 'Forty 
e.errorMessage()); 
public void testMissingDoubleMessage() throws Exception 1 


ArgsException e = new 
ArgsException(ArgsException.ErrorCode.MISSING_DOUBLE, 


'x', null); 
assertEquals("Could not find double parameter for -x." 
e.errorMessage()); 
} 
} 
代码 清单 14-15 ArgsException.java 
public class ArgsException extends Exception { 
private char errorArgumentld = '\0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
public ArgsException() {} 
public ArgsException(String message) {super(message); } 
public ArgsException(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public ArgsException(ErrorCode errorCode, String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
} 
public ArgsException(ErrorCode errorCode, char errorArgumentl d, 
String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentld; 
} 
public char getErrorArgumentld() { 


return errorArgumentld; 


} 
public void setErrorArgumentId(char errorArgumentId) { 
this.errorArgumentId = errorArgumentld; 
} 
public String getErrorParameter() { 
retum errorParameter; 
} 
public void setErrorParameter(String errorParameter) { 
this.errorParameter = errorParameter; 
} 
public ErrorCode getErrorCode() { 
return errorCode; 
} 
public void setErrorCode(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return String.format("Argument -%c unexpected.", 
errorArgumentld); 
case MISSING_STRING: 
return String.format("Could not find string parameter for - 
%c.", 


errorArgumentld); 


case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but 
was '%s'.", 
errorArgumentld, errorParameter); 
case MISSING_INTEGER: 
retum String.format("Could not find integer parameter for - 
%c.", 
errorArgumentld); 
case INVALID_DOUBLE: 
return String.format("Argument -%c expects a double but was 
DOS s 
errorArgumentld, errorParameter); 
case MISSING_DOUBLE: 
return String.format("Could not find double parameter for - 
%c.", 
errorArgumentld); 
} 
return ""; 
} 
public enum ErrorCode { 
OK, INVALID FORMAT, UNEXPECTED_ARGUMENT, 
INVALID ARGUMENT NAME, 
MISSING. STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE] 
j 
代码 清单 14-16 Args.java 


public class Args { 
private String schema; 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private Iterator<String> currentArgument; 
private List<String> argsList; 
public Args(String schema, String[] args) throws ArgsException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
parse(); 
} 
private void parse() throws ArgsException { 
parseSchema(); 
parseArguments(); 
} 
private boolean parseSchema() throws ArgsException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 


parseSchemaElement(element.trim()); 


} 

return true; 

j 

private void parseSchemaElement(String element) throws 
ArgsException { 


char elementId = element.charAt(0); 


String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else 
throw new 
ArgsException(ArgsException.ErrorCode.INVALID_FORMAT, 
elementId, elementTail); 
} 
private void — validateschemaElementId(char elementld) throws 
ArgsException { 
if (!Character.isLetter(elementId)) { 
throw new 
ArgsException(ArgsException.ErrorCode.INVALID ARGUMENT NA 


elementld, null); 


} 
private void parseArguments() throws ArgsException { 
for (currentArgument = argsList.iterator(); 
currentArgument.hasNext();) { 


String arg = currentArgument.next(); 


parseArgument(arg); 


} 


private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
j 
private void parseElement(char argChar) throws ArgsException 1 
if (setArgument(argChar)) 
argsFound.add(argChar); 


else { 
throw new 
ArgsException(ArgsException.ErrorCode. U.NEXPECTED ARGUMEN 
argChar, null); 
} 


} 


private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
retum false; 
try { 
m.set(currentArgument); 


return true; 


} catch (ArgsException e) { 
e.setErrorArgumentId(argChar); 


throw e; 


} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
} 
public boolean getBoolean(char arg) { 
ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 
try { 
b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) { 
b = false; 
} 
return b; 
} 
public String getString(char arg) { 


ArgumentMarshaler am = marshalers.get(arg); 


try { 


return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) { 


n", 


return ""; 


j 
public int getInt(char arg) 1 
ArgumentMarshaler am = marshalers.get(arg); 
try 1 
return am —- null ? 0 : (Integer) am.get(); 
} catch (Exception e) { 


return 0; 


} 
public double getDouble(char arg) { 
ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Double) am.get(); 
} catch (Exception e) { 
return 0.0; 
} 
} 
public boolean has(char arg) { 


return argsFound.contains(arg); 


} 
对 Args 类 所 做 的 最 主要 的 修改 是 在 监测 部 分 。 从 Args 里 面 取 出 了 
大 量 代码 ， 放 到 ArgsException 中 。 很 好 。 我 们 还 把 全 部 


ArgumentMarshaler 转 移 到 了 它们 自己 的 文件 中 。 更 好 ! 优秀 的 软件 设 
计 ， 大 都 关乎 分 隔 一 一 创建 合适 的 空间 放置 不 同 种 类 的 代码 。 对 关注 面 
的 分 隅 让 代码 更 易于 理解 和 维护 。 

特别 有 意思 的 是 ArgsException 中 的 errorMessage 方 法 。 显 然 ， 把 错 
误 信 息 格式 化 操作 放 在 Args 里 面 ， 违 反 了 SRP 原 则 。Args 应 该 只 处 理 参 
数 ， 不 该 去 管 错 误 信 息 的 格式 。 然 而 ， 把 错误 信息 格式 化 代码 放 到 
ArgsException 中 是 否 有 道理 呢 ? 

实话 说 ， 这 是 种 折 训 做 法 。 不 打算 用 ArgsException 提 供 的 错误 信息 
的 用 户 会 想 自 己 写 错误 信息 。 但 如 果 有 备 好 的 错误 信息 ， 其 方便 之 处 也 
并 非 鲜 见 。 

现在 ， 显 然 我 们 已 经 非常 接近 本 章 开 始 处 所 展示 的 最 终 解决 方案 
了 。 最 后 的 工作 留 给 你 来 练习 完成 。 














14.4 小 结 


代码 能 工作 还 不 够 。 能 工作 的 代码 经 和 常会 严重 骨 沉 。 满 足 于 仪 仅 让 
代码 能 工作 的 程序 员 不 够 专业 。 他 们 会 害怕 没 时 间 改 进 代码 的 结构 和 设 
th, RABAT). Bett A Be LORRY TIR T ACI H "i 2 ERE RTI HH 
的 损害 了 。 进 度 可 以 重 订 ， 需 求 可 以 重新 定义 ， 团 队 动 态 可 以 修正 。 但 
糟糕 的 代码 只 是 一 直 腐 败 发 酵 ， 无 情 地 拖 着 团队 的 后 腿 。 我 无 数 次 看 到 
开发 团队 哺 中 前 行 ， 只 因为 他 们 匆匆 摘出 一 片 代码 沼 译 ， 从 此 之 后 命运 
再 也 不 受 自己 控制 。 

当然 ， 糟 糕 的 代码 可 以 清理 。 不 过 成 本 高 郧 。 随 着 代码 腐败 下 去 ， 
模块 之 间 互 相 渗 透 ， 出 现 大 量 隐藏 纠结 的 依赖 关系 。 找 到 和 破除 陈旧 的 
依赖 关系 义 费 时 间 又 费劲 。 另 一 方面 ， 保 持 代 码 整 洁 却 相对 容易 。 早 晨 
在 模块 中 制造 出 一 堆 混 乱 ， 下 午 就 能 轻易 清理 抒 。 更 好 的 情况 是 ，5 分 
钟 之 前 制造 出 混乱 ， 马 上 就 能 很 容易 地 清理 掉 。 

所 以 ， 解 决 之 道 就 是 保持 代码 持续 整洁 和 简单 。 永 不 让 腐 坏 有 机 会 
开始 。 














[11. 原 注 : 最 近 我 用 Ruby 语 言 重 写 了 这 个 模块 。 大 概 只 有 Java 版 本 的 1/7 
大 小 ， 而 且 结 构 也 稍 好 一 些 。 


[2]. 译 注 : 即 创建 一 个 类 型 为 ArgumentMarshaler 的 对 象 实体 。 


[3]. 原 注 : 为 了 避免 这 种 情况 发 生 ， 我 添加 了 一 个 新 的 单元 测试 ， 调 用 
所 有 FitNesse 测 试 。 
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15.1 JUnit 杠 架 


JUnit 有 很 多 位 作者 ， 但 它 始 于 Kent Beck 和 Eric Gamma 一 次 去 亚 特 
兰 大 的 飞行 旅程 。Kent 想 学 Java， 而 Eric 则 打算 学 习 Kent 的 Smalltalk 测 试 
框架 。“ 对 于 两 个 喘 处 狭窄 空间 的 奇 客 ， 还 有 什么 会 比 拿 出 笔记 本 电脑 
开始 编码 来 得 更 自然 昵 ?[1]”* 经 过 3 小 时 高 海拔 工作 ， 他 们 写 出 了 JUnit 
的 基础 代码 。 

我 们 要 查看 的 模块 ， 是 用 来 帮忙 鉴别 字符 串 比较 错误 的 一 段 聪明 代 
码 。 该 模块 被 命名 为 ComparisonCompactor。 对 于 两 个 不 同 的 字符 串 ， 
例如 ABCDE 和 ABXDE， 筷 将 用 形 如 <.…B[X]D.…> 的 字符 串 来 曝露 两 者 
的 不 同 之 处 。 

我 可 以 做 进一步 解释 ， 但 测试 用 例会 更 有 说 服 力 。 看 看 代码 清单 
15-1， 你 将 深入 了 解 到 该 模块 满足 的 需求 。 边 看 代码 ， 边 研究 该 测试 的 
结构 。 它 们 能 变 得 更 简洁 或 更 明确 吗 ? 

代码 清单 15-1 ComparisonCompactorTest.java 


























package junit.tests.framework; 
import junit.framework.ComparisonCompactor; 
import junit.framework. TestCase; 
public class ComparisonCompactorTest extends TestCase { 
public void testMessage() { 
String failure= new ComparisonCompactor(0, "b", 
"c").compact("a"); 


assertTrue("a expected:<[b]> but was:<[c]>".equals(failure)); 


public void testStartSame() 1 


String failure= new ComparisonCompactor(1, 


"bc").compact(null); 
assertEquals("expected:«b[a]» but was:<b[c]>", failure); 
} 
public void testEndSame() { 


String failure= new ComparisonCompactor(1, 


"cb").compact(null); 
assertEquals("expected:<[a]b> but was:<[c]b>", failure); 
} 
public void testSame() { 


String failure= new ComparisonCompactor(1, 


"ab").compact(null); 
assertEquals("expected:<ab> but was:<ab>", failure); 
} 
public void testNoContextStartAndEndSame() { 
String failure= new ComparisonCompactor(0, 


"adc").compact(null); 


assertEquals("expected:<...[b]...> but was:<...[d]...>", failure); 


} 
public void testStartAndEndContext() { 
String failure= new ComparisonCompactor(1, 
"adc").compact(null); 
assertEquals("expected:<a[b]c> but was:<a[d]c>", failure); 
} 
public void testStartAndEndContextWithEllipses() 1 


String failure= 


"ba", 


"ab", 


"ab", 


" " 


abc", 


" " 


abc", 


new ComparisonCompactor(1, "abcde", "abfde").compact(null); 
assertEquals("expected:<...b[c]d...> but was:<...b[f]d...>", failure); 
} 
public void testComparisonErrorStartSameComplete() { 
String failure= new ComparisonCompactor(2, "ab", 
"abc").compact(null); 
assertEquals("expected:<ab[]> but was:<ab[c]>", failure); 
} 
public void testComparisonErrorEndSameComplete() { 
String failure= new ComparisonCompactor(0, "be", 
"abc").compact(null); 
assertEquals("expected:<[]...> but was:<[a]...>", failure); 
} 
public void testComparisonErrorEndSameCompleteContext() { 
String failure= new ComparisonCompactor(2, "bc", 
"abc").compact(null); 
assertEquals("expected:<[]bc> but was:<[a]bc>", failure); 
} 


public void testComparisonErrorOverlapingMatches() { 


String failure= new ComparisonCompactor(0, "abc", 
"abbc").compact(null); 
assertEquals("expected:<...[]...> but was:<...[b]...>", failure); 
} 
public void testComparisonErrorOverlapingMatchesContext() { 
String failure= new ComparisonCompactor(2, "abc", 


"abbc").compact(null); 


assertEquals("expected:<ab[]c> but was:<ab[b]c>", failure); 


} 

public void testComparisonErrorOverlapingMatches2() { 
String failure= new ComparisonCompactor(0, "abcdde", 
"abcde").compact(null); 
assertEquals("expected:<...[d]...> but was:<...[]...>", failure); 

j 

public void testComparisonErrorOverlapingMatches2Context() 1 
String failure- 

new ComparisonCompactor(2, "abcdde", "abcde").compact(null); 

assertEquals("expected:<...cd[d]e> but was:<...cd[]e>", failure); 


j 
public void testComparisonErrorWithA ctualNull() 1 
String failure- new ComparisonCompactor(0, "a", 
null).compact(null); 
assertEquals("expected:<a> but was:<null>", failure); 


} 
public void testComparisonErrorWithActualNullContext() { 
String failure= new ComparisonCompactor(2, "a", 
null).compact(null); 
assertEquals("expected:<a> but was:<null>", failure); 
} 
public void testComparisonErrorWithExpectedNull() { 
String failure= new ComparisonCompactor(0, null, 
"a").compact(null); 
assertEquals("expected:<null> but was:<a>", failure); 
} 
public void testComparisonErrorWithExpectedNullContext() { 


String failure= new ComparisonCompactor(2, null, 
"a").compact(null); 
assertEquals("expected:<null> but was:<a>", failure); 
} 
public void testBug609972() { 
String failure= new ComparisonCompactor(10, "S&P500", 
"0").compact(null); 
assertEquals("expected:<[S&P50]0> but was:<[]0>", failure); 


} 

我 对 用 到 这 些 测 试 的 ComparisonCompactor 进 行 了 代码 履 盖 分 析 。 
代码 被 100% 禾 新 了 。 每 行 代码 、 每 个 if 语 句 和 for 人 循环 都 被 测试 执行 了 。 
于 是 我 对 代码 的 工作 能 力 有 了 极 高 的 信心 ， 也 对 代码 作者 们 的 技艺 产生 
了 极 高 的 尊敬 。 

ComparisonCompactor 的 代码 如 代码 清单 15-2 所 示 。 

代码 清单 15-2 ComparisenCompactor.java (原始 版 本 ) 


package junit.framework; 





public class ComparisonCompactor { 
private static final String ELLIPSIS = "..."; 
private static final String DELTA_END = "]"; 
private static final String DELTA_START = "["; 
private int fContextLength; 
private String fExpected; 
private String fActual; 
private int fPrefix; 
private int fSuffix; 


public ComparisonCompactor(int contextLength, 


String expected, 
String actual) { 
fContextLength = contextLength; 
fExpected = expected; 
fActual = actual; 
} 
public String compact(String message) { 
if (fExpected == null || fActual == null || areStringsEqual()) 
return Assert.format(message, fExpected, fActual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(fExpected); 
String actual = compactString(fActual); 
return Assert.format(message, expected, actual); 
} 
private String compactString(String source) { 
String result = DELTA_START + 
source.substring(fPrefix, source.length() - 
fSuffix + 1) + DELTA_END; 
if (fPrefix > 0) 
result = computeCommonPrefix() + result; 
if (fSuffix > 0) 
result = result + computeCommonSuffix(); 
return result; 
} 
private void findCommonPrefix() { 
fPrefix = 0; 


int end = Math.min(fExpected.length(), fActual.length()); 
for (; fPrefix < end; fPrefix++) { 
if (fExpected.charAt(fPrefix) != fActual.charAt(fPrefix)) 
break; 


} 
private void findCommonSuffix() { 

int expectedSuffix = fExpected.length() - 1; 

int actualSuffix = fActual.length() - 1; 

for (; 

actualSuffix >= fPrefix && expectedSuffix >= fPrefix; 
actualSuffix--, expectedSuffix--) { 
if (fExpected.charAt(expectedSuffix) l= 
fActual.charAt(actualSuffix)) 
break; 

} 

fSuffix = fExpected.length() - expectedSuffix; 
} 
private String computeCommonPrefix() { 

return (fPrefix > fContextLength ? ELLIPSIS : "") + 

fExpected.substring(Math.max(0, fPrefix - fContextLength), 
fPrefix); 

} 
private String computeCommonSuffix() { 

int end =  Math.min(fExpected.length() - fSuffix + 1 + 

fContextLength, 
fExpected.length()); 


return fExpected.substring(fExpected.length() - fSuffix + 1, end) + 
(fExpected.length() - fSuffix + 1 < fExpected.length() - 
fContextLength ? ELLIPSIS : ""); 


private boolean areStringsEqual() { 


return fExpected.equals(fA ctual); 


j 
你 可 能 会 对 这 个 模块 有 所 抱怨 。 里 面 有 些 长 表达 式 ， 有 些 奇 怪 的 +1 
操作 ， 如 此 等 等 。 不 过 ， 总 的 来 说 ， 这 个 模块 很 不 错 。 毕 竟 它 原本 可 能 
被 写成 如 代码 清单 15-3 中 的 样子 。 
代码 清单 15-3 ComparisenCompator.java (背离 版 本 ) 
package junit.framework; 
public class ComparisonCompactor { 
private int ctxt; 
private String s1; 
private String s2; 
private int pfx; 
private int sfx; 
public ComparisonCompactor(int ctxt, String s1, String s2) { 
this.ctxt = ctxt; 
this.s1 = s1; 
this.s2 = s2; 
} 
public String compact(String msg) { 
if (s1 == null || s2 == null || s1.equals(s2)) 


return Assert.format(msg, s1, s2); 


pfx = 0; 
for (; pfx < Math.min(s1.length(), s2.length()); pfx++) 1 
if (s1.charAt(pfx) != s2.charAt(pfx)) 
break; 
} 
int sfx1 = s1.length() - 1; 
int sfx2 = s2.length() - 1; 
for (; sfx2 >= pfx && sfx1 >= pfx; sfx2--, sfx1--) { 
if (s1.charAt(sfx1) != s2.charAt(sfx2)) 
break; 
j 
sfx = s1.length() - sfx1; 
String cmp1 = compactString(s1); 
String cmp2 = compactString(s2); 
return Assert.format(msg, cmp1, cmp2); 
j 
private String compactString(String s) 1 
String result = 
"[" + s.substring(pfx, s.length() - sfx + 1) + "]"; 
if (pfx > 0) 
result = (pfx > ctxt ? "..." : ") + 
s1.substring(Math.max(0, pfx - ctxt), pfx) + result; 
if (sfx > 0) { 
int end = Math.min(s1.length() - sfx + 1 + ctxt, s1.length()); 
result = result + (s1.substring(s1.length() - sfx + 1, end) + 
(s1.length() - sfx + 1 < s1.length() - ctxt ? "..." : "")); 


return result; 


} 
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们 ， 离 时 要 比 来 时 整洁 。 所 以 ， 我 们 怎样 才能 改进 代码 清单 15-2 中 的 原 
始 代码 呢 ? 

我 首先 看 到 的 是 成 员 变 量 的 f 前 级 [N6]。 在 现今 的 运行 环境 中 ， 这 
类 范围 性 编码 纯 属 多 余 。 所 以 ， 先 删除 所 有 的 f 前 级 。 


private int contextLength; 





private String expected; 
private String actual; 
private int prefix; 
private int suffix; 
下 一 步 ， 在 compact 函 数 开 始 处 ， 有 一 个 未 封装 的 条 件 判 断 [G28]。 
public String compact(String message) { 
if (expected == null || actual == null || areStringsEqual()) 
return Assert.format(message, expected, actual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(this.expected); 
String actual = compactString(this.actual); 


return Assert.format(message, expected, actual); 


个 条 件 判 断 应 当 封 装 起 来 ， 从 而 更 清晰 地 表达 代码 的 意图 。 我 们 
iu 个 条 件 判断 。 
public String compact(String message) { 
if (shouldNotCompact()) 


return Assert.format(message, expected, actual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 
} 
private boolean shouldNotCompact() { 
return expected == null || actual == null || areStringsEqual(); 
} 
我 也 不 太 喜 欢 compact 函 数 中 的 this.expected 和 this.actual 符 号 。 这 个 
是 我 们 把 全 xpected 改 为 expected 时 发 生 的 。 为 什么 函数 中 的 变量 会 与 成 








员 变 量 同 名 呢 ? 它们 不 是 该 表示 其 他 意思 吗 [N4]? 我 们 应 该 区 分 这 些 名 
称 。 


String compactExpected = compactString(expected); 
String compactActual = compactString(actual); 
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转 条 件 判断 。 
public String compact(String message) { 
if (canBeCompacted()) { 
findCommonPrefix(); 
findCommonSuffix(); 
String compactExpected = compactString(expected); 
String compactActual = compactString(actual); 
return Assert.format(message, compactExpected, compactActual); 
} else { 


return Assert.format(message, expected, actual); 


} 
private boolean canBeCompacted() { 
return expected != null && actual != null && !areStringsEqual(); 

} 

函数 名 很 奇怪 [N7]。 尽 管 它 的确 会 压缩 字符 串 ， 但 如 果 
canBeCompact ”为 false， 它 实际 上 就 不 会 压缩 字符 串 。 用 compact 来 命 
名 ， 隐 藏 了 错误 检查 的 副作用 。 注 意 ， 该 函数 返回 一 条 格式 化 后 的 消 
恩 ， 而 不 仅仅 只 是 压缩 后 的 字符 串 。 所 以 ， 困 数 名 其 实 应 该 是 
formatCompacted ” Comparison。 在 用 以 下 参数 调用 时 ， 读 起 来 会 好 很 
多 : 

public String formatCompactedComparison(String message) { 

两 个 字符 串 是 在 主语 句 体 中 压缩 的 。 我 们 应 当 拆 分 出 一 个 名 为 
compactExpectedAndActual 的 方法 。 然 而 ， 我 们 希望 
formatCompactComparison 冰 数 完成 所 有 的 格式 化 工作 。 而 compact... 
数 除了 压缩 之 外 什么 都 不 做 [G30]。 上 所以， 做 如 下 拆 分 : 











Bal 


private String compactExpected; 


private String compactActual; 


public String formatCompactedComparison(String message) { 
if (canBeCompacted()) { 
compactExpectedAndActual(); 
return Assert.format(message, compactExpected, 
compactActual); 
} else { 


return Assert.format(message, expected, actual); 


} 
private void compactExpectedAndA ctual() { 


findCommonPrefix(); 
findCommonSuffix(); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 
} 
注意 ， 这 要 求 我 们 同 成 员 变 量 举荐 compactExpected 和 
compactActual。 我 不 喜欢 新 函数 最 后 两 行 返回 变量 的 方式 ， 但 前 两 个 可 
不 是 这 样 。 它 们 没 采 用 一 以 贯 之 的 约定 [G11]。 我 们 应 该 修改 
findCommonPrefix#llfindCommonSuffix, i [ul Bij Z& Jc: 28H « 








private void compactExpectedAndActual() 1 
prefixIndex = findCommonPrefix(); 
suffixIndex = findCommonSuffix(); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 
} 
private int findCommonpPrefix() { 
int prefixIndex = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex++) { 
if (expected.charAt(prefixIndex) != actual.charAt(prefixIndex)) 
break; 
return prefixIndex; 


} 


private int findCommonSuffix() { 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; actualSuffix >= prefixIndex && expectedSuffix >= prefixIndex; 
actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) != actual.charAt(actualSuffix)) 
break; 
return expected.length() - expectedSuffix; 
} 
} 
我 们 还 应 该 修改 成 员 变 量 的 名 称 ， 使 之 更 准确 一 点 [N1]; 毕竟 它们 
都 是 索引 。 
仔细 检查 findCommonSuffixz， 其 中 藏 了 个 时 序 性 耦合 [G31]; 它 依 
赖 于 prefixIndex 是 由 findCommonSuffix 计 算得 来 的 事实 。 如 果 这 两 个 方 
法 不 是 按 这 样 的 顺序 调用 ， 调 试 就 会 变 得 困难 。 为 了 姑 露 这 个 时 序 性 耦 
合 ， 我 们 将 prefixIndex 做 成 find 的 参数 。 
private void compactExpectedAndActual() { 





prefixIndex = findCommonPrefix(); 
suffixIndex = findCommonSuffix(prefixIndex); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 
} 
private int findCommonSuffix(int prefixIndex) { 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; actualSuffix >= prefixIndex && expectedSuffix >= prefixIndex; 


actualSuffix--, expectedSuffix--) { 


if (expected.charAt(expectedSuffix) != actual.charAt(actualSuffix)) 
break; 
} 


return expected.length() - expectedSuffix; 


} 
我 对 这 样 的 方式 不 太 满 意 。 传 递 prefixIndex 参数 有 些 随 意 [G32]。 











它 成 功 维持 了 执行 次 序 ， 但 对 于 解释 排序 的 需要 却 坚 无 作用 。 其 他 程序 


XB i 


可 能 会 抹杀 我 们 刚 完成 的 工作 ， 因 为 并 没有 迹象 说 明 该 参数 确 属 必 
还 是 采取 别 的 做 法 吧 。 
private void compactExpectedAndActual() { 
findCommonPrefixAndSuffix(); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 
} 
private void findCommonPrefixAndSuffix() 1 
findCommonPrefix(); 
int expectedSuffix = expected.length() - 1; 


int actualSuffix = actual.length() - 1; 


for (; 
actualSuffix >= prefixIndex && expectedSuffix >= 
prefixIndex; 
actualSuffix--, expectedSuffix-- 
){ 
if (expected.charAt(expectedSuffix) != actual.charAt(actualSuffix)) 
break; 
} 


suffixIndex = expected.length() - expectedSuffix; 


} 
private void findCommonPrefix() 1 
prefixIndex = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex++) 
if (expected.charAt(prefixIndex) != actual.charAt(prefixIndex)) 
break; 

} 

我 们 恢复 fndCommonPreffix 和 findCommonSuffix 的 原样 ， 把 
findCommonSuffix 的 名 称 改 为 fndCommonPrefixAndSuffix， 让 它 在 执行 
其 他 操作 之 前 ， 先 调用 findCommonPrefix。 这 样 一 来 ， 就 以 一 种 相 比 前 
种 手段 更 为 有 效 的 方式 建 这 了 两 个 图 数 之 间 的 时 序 关 系 。 

private void findCommonPrefixAndSuffix() 1 

findCommonPrefix(); 
int suffixLength = 1; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) { 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength)) 
break; 
} 
suffixIndex = suffixLength; 
} 
private char charFromEnd(String s, int i) { 
return s.charAt(s.length()-i); 
} 
private boolean suffixOverlapsPrefix(int suffixLength) { 


return actual.length() - suffixLength < prefixLength || 


expected.length() - suffixLength < prefixLength; 

} 
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没 取 好 。 对 于 ”prefix 也 是 如 此 。 虽 然 在 那样 一 种 情形 下 index 和 length 是 
同 义 的 ， 但 使 用 length 一 词 却 更 有 一 吐 性 。 问 题 在 于 ，suffixIndex 变 量 并 
不 从 0 开始 ， 它 从 1 开始 ， 所 以 并 非 真正 的 长 度 。 这 也 是 
computeCommonSuffix 中 那些 +1 存 在 的 原因 [G33]。 来 修正 它们 吧 。 结 果 
就 是 代码 清单 15-4。 

代码 清单 15-4 ComparisenCompactor.java (过 渡 版 本 ) 


public class ComparisonCompactor { 
private int suffixLength; 


private void findCommonPrefixAndSuffix() { 
findCommonPrefix(); 
suffixLength = 0; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) { 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength)) 
break; 


} 
private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
} 
private boolean suffixOverlapsPrefix(int suffixLength) { 


return actual.length() - suffixLength <= prefixLength || 


expected.length() - suffixLength <= prefixLength; 


private String compactString(String source) { 

String result = 
DELTA, START + 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA, END; 

if (prefixLength > 0) 
result = computeCommonPrefix() + result; 

if (suffixLength > 0) 
result = result + computeCommonSuffix(); 


return result; 


private String computeCommonSuffix() { 
int end = Math.min(expected.length() - suffixLength + 
contextLength, expected.length() 
); 
return 
expected.substring(expected.length() - suffixLength, end) + 
(expected.length() - suffixLength < 
expected.length() - contextLength ? 
ELLIPSIS : ""); 
} 
我 们 用 charFromEnd 中 的 那个 -1 苦 代 了 computeCommonSuffix 中 的 一 
堆 +1， 前 者 更 为 合情合理 ，suffixOverlapsPrefix 中 的 两 个 “<=” 操 作 符 也 


同 理 。 这 样 我 们 就 能 修改 suffixIndex 和 suffixLength 的 名 称 ， 极 大 地 提升 
了 代码 的 可 读 性 。 

不 过 还 有 一 个 问题 。 在 消灭 那些 +1 时 ， 我 注意 到 compactString 中 的 
以 下 代码 : 

if (suffixLength > 0) 

看 看 代码 清单 15-4 中 的 这 行 代 人 码 。 因 为 suffixLength 现 在 要 比 原本 少 
1， 我 应 该 把 “>” 操 作 符 改 为 “>=” 操 作 符 。 那 本 无 道理 ， 不 过 现在 却 有 意 
X! 这 表示 这 人 么 做 没 道理 ， 而 且 可 能 是 个 缺陷 。 嗯 ， 也 不 算是 个 缺陷 。 
从 之 前 的 分 析 中 我 们 可 以 看 到 ， 让 语句 现在 会 放置 添加 长 度 为 零 的 后 
级 。 在 作出 修改 之 前 ，if 语 句 没 有 作用 ， 因 为 suffixIndex 永 不 会 小 于 1。 

这 说 明 compactString 中 的 两 个 f 语 句 都 有 问题 ! 看 起 来 它们 都 该 删 
除 。 所 以 ， 我 们 将 其 注释 掉 ， 运 行 测试 。 测 试 通过 了 :! 那 就 重新 构架 
compactString， 删 除 没 用 的 这 语句 ， 将 函数 改 得 更 加 简洁 [G9]。 


private String compactString(String source) { 





return 
computeCommonPrefix() + 
DELTA_START + 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA_END + 
computeCommonSuffix(); 

} 

这 样 就 好 多 了 ! 现在 我 们 看 到 ，compactString 函 数 只 是 把 片段 组 合 
起 来 。 我 们 甚至 可 以 让 它 更 清晰 。 有 许多 细微 的 整理 工作 可 做 。 与 其 拖 
着 你 过 有 历 剩 下 的 那些 修改 ， 我 更 愿意 直接 展示 代码 清单 15-5 中 的 结 

代码 清单 15-5 ComparisenCompactor.java 〈 最 终 版 ) 

package junit.framework; 


public class ComparisonCompactor { 


private static final String ELLIPSIS = "..."; 
private static final String DELTA, END = "]"; 
private static final String DELTA_START = "["; 
private int contextLength; 
private String expected; 
private String actual; 
private int prefixLength; 
private int suffixLength; 
public ComparisonCompactor( 
int contextLength, String expected, String actual 
){ 
this.contextLength = contextLength; 
this.expected = expected; 
this.actual = actual; 
} 
public String formatCompactedComparison(String message) { 
String compactExpected = expected; 
String compactActual = actual; 
if (shouldBeCompacted()) { 
findCommonPrefixAndSuffix(); 
compactExpected = compact(expected); 
compactActual = compact(actual); 
j 
return Assert.format(message, compactExpected, compactA ctual); 
j 
private boolean shouldBeCompacted() 1 
return !shouldNotBeCompacted(); 


} 
private boolean shouldNotBeCompacted() { 


return expected == null || 
actual == null || 
expected.equals(actual); 
} 
private void findCommonPrefixAndSuffix() 1 
findCommonPrefix(); 
suffixLength = 0; 
for (; !suffixOverlapsPrefix(); suffixLength++) { 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength) 


break; 


} 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
} 
private boolean suffixOverlapsPrefix() { 
return actual.length() - suffixLength <= prefixLength || 
expected.length() - suffixLength <= prefixLength; 
} 
private void findCommonPrefix() 1 
prefixLength = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixLength < end; prefixLength++) 


if (expected.charAt(prefixLength) l= actual.charAt 
(prefixLength)) 
break; 
} 
private String compact(String s) { 
return new StringBuilder() 
.append(startingEllipsis()) 
.append(startingContext()) 
.append(DELTA START) 
.append(delta(s)) 
.append(DELTA_ END) 
.append(endingContext()) 
.append(endingEllipsis()) 
.toString(); 
} 
private String startingEllipsis() { 
return prefixLength > contextLength ? ELLIPSIS : ""; 
} 
private String startingContext() { 
int contextStart = Math.max(0, prefixLength - contextLength); 
int contextEnd = prefixLength; 
return expected.substring(contextStart, contextEnd); 
} 
private String delta(String s) { 
int deltaStart = prefixLength; 
int deltaEnd = s.length() - suffixLength; 
return s.substring(deltaStart, deltaEnd); 


} 
private String endingContext() { 
int contextStart = expected.length() - suffixLength; 
int contextEnd = 
Math.min(contextStart + contextLength, expected.length()); 
return expected.substring(contextStart, contextEnd); 
} 
private String endingEllipsis() { 
return (suffixLength > contextLength ? ELLIPSIS : ""); 
} 
} 
这 的 确 很 漂亮 。 模 块 分 解 成 了 一 组 分 析 函 数 和 一 组 合成 函数 。 它 们 
以 一 种 拓扑 方式 排序 ， 每 个 函数 的 定义 都 正好 在 其 被 调用 的 位 置 后 面 。 
所 有 的 分 析 函 数 都 先 出 现 ， 而 所 有 的 合成 函数 都 最 后 出 现 。 
仔细 阅读 ， 你 会 及 现 我 推翻 了 在 本 章 较 前 位 置 做 出 的 几 个 决定 。 例 
如 ， 我 将 几 个 分 解 出 来 的 方法 重新 内 联 为 formatCompactComparison， 我 
修改 了 souldNotBeCompacted 表 达 式 的 意思 。 这 种 做 法 很 常见 。 重 构 常 
会 导致 男 一 次 推翻 此 次 重 构 的 重 构 。 重 构 是 一 种 不 集 试 错 的 达 代 过 程 ， 
不 可 避免 地 集中 于 我 们 认为 是 专业 人 员 该 做 的 事 。 
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说 它 原本 不 整洁 。 作 者 们 做 了 蛙 越 的 工作 。 但 模块 都 能 再 改进 ， 我 们 每 
个 人 也 有 责任 把 模块 改进 得 比 发 现时 更 整洁 。 





[11. 原 注 : JUnit Pocket Guide, Kent Beck, O’Reilly, 2004, P.43. 
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JCommon 类 库 。 深 入 该 类 库 ， 其 中 有 个 名 为 org.jfree.date 的 程序 包 。 在 
该 程序 包 中 ， 有 个 名 为 SerialDate 的 类 。 我 们 即将 剖析 这 个 类 。 

SerialDate 的 作者 是 David Gilbert。David 显 然 是 位 经 验 丰 富 、 能 力 足 
够 的 程序 员 。 如 我 们 将 看 到 的 ， 他 在 代码 中 展示 了 极 高 的 专业 性 和 原则 





性 。 无 论 怎 么 说 ， 这 都 是 “好 代码 ”。 而 我 将 把 它 撕 成 雁 片 。 

这 并 非 恶 意 的 行为 。 我 也 不 认为 目 己 比 戴 维 强 许多 ， 有 权 对 他 的 代 
码 说 三 道 四 。 其 实 ， 如 果 你 看 过 我 的 代码 ， 我 敢 说 你 也 会 发 现 好 些 该 埋 
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不 ， 这 也 并 非 傲慢 无 礼 的 行为 。 我 所 要 做 的 ， 只 是 一 种 专业 眼光 的 
检视 ， 不 多 也 不 少 。 那 是 我 们 都 该 坦然 接受 的 做 法 。 那 是 我 们 应 该 欢迎 
别人 对 自己 做 的 事 。 只 有 通过 这 样 的 批评 ， 我 们 才能 学 到 东西 。 医 生 惑 
是 这 样 做 的 。 尺 行 员 就 是 这 样 做 的 。 律 师 就 是 这 样 做 的 。 我 们 程序 员 也 








需要 学 习 如 何 这 样 做 。 

多 说 一 句 关 于 David Gilbert 的 事 : David 不 止 是 位 优秀 的 程序 员 。 戴 
维 有 着 将 代码 免费 呈献 给 社区 的 勇气 和 好 心 。 他 公开 代码 ， 让 所 有 人 都 
能 看 到 ， 邀 请 大 众 使 用 并 审查 。 做 得 真 好 ! 

SerialDate《〈 见 代码 清单 B-1) 是 一 个 用 Java 呈现 一 个 日 期 的 类 。 为 
什么 在 Java 已 经 有 java.util.Date 和 java.util.Calendar 的 时 候 ， 还 需要 一 个 
呈现 日 期 的 类 呢 ? 作者 编写 这 个 类 ， 是 为 了 啊 应 我 自己 也 常 感到 的 痛 
苗 。 在 开放 的 Javadoc( 第 67 行 ) 中 ， 他 很 好 地 解释 了 原因 。 我 们 可 以 
质疑 他 的 初 训 ， 但 我 的 确 有 处 理 这 个 问题 的 需要 ， 而 且 我 也 欢迎 有 个 关 
心 日 期 其 于 时 间 的 类 存在 。 


16.1 让 它 能 工 


在 一 个 名 为 SerialDateTests 的 类 《〈 见 代码 清单 B-2) 中 ， 有 一 些 单元 
测试 。 测 试 都 通过 了 。 不 笠 的 是 ， 快 览 一 损 测试 ， 发 现 它们 并 没有 测试 
所 有 东西 [T1]。 例 如 ， 用 “查找 使 用 ”搜索 方法 MonthCodeToQuarter (第 
334 行 ) ， 会 发 现 没 有 被 用 过 [F4]。 因 此 ， 单 元 测试 并 没有 测试 这 个 方 
iE. 
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说 ， 在 SerialDate 的 185 个 可 执行 语句 中 ， 单 元 测试 只 执行 了 91 个 “〈 约 
50%) [T2]. 78 mR AERE — VR TERI BI. ER LÁBISDA 
块 的 未 执行 代码 。 

我 的 目标 是 完整 地 理解 和 重 构 这 个 类 。 没 有 好 得 多 的 测试 履 盖 率 ， 
做 不 到 这 个 。 所 以 ， 我 完全 重 起 炉灶 编号 了 自己 的 单元 测试 〈 见 代码 清 
单 B-4) 。 

在 阅读 这 些 测试 时 ， 你 可 以 看 到 ， 其 中 许多 注释 挥 了 。 这 些 测试 不 
能 通过 。 它 们 代表 了 我 以 为 SerialDate 应 该 有 的 行为 。 在 我 重 构 
SerialDate 时 ， 也 将 让 这 些 测 斌 通过。 

即便 有 些 测 试 被 注释 掉 ，Clover 还 是 报告 新 的 单元 测试 执行 了 185 
个 可 执行 语句 中 的 170 个 (92%) 。 这 样 就 好 多 了 ， 而 且 我 想 我 们 可 以 
把 这 个 数字 提高 些 。 

前 几 个 注释 掉 的 测试 〈 第 23 一 63 行 ) 是 我 一 厢 情 愿 。 程 序 并 没有 设 
计 为 通过 这 些 测 试 ， 但 对 我 来 说 它们 代表 的 行为 显而易见 [G2]。 我 不 太 
确定 testWeekdayCodeToString 方 法 为 何 要 写成 那样 ， 不 过 既然 它 已 经 在 
那儿 ， 显 然 不 该 是 区 分 大 小 写 的 。 编 写 这 些 测试 是 区 区 小 事 [T3]， 通 过 





























测试 更 加 容易 。 我 只 修改 了 第 259 行 和 和 263 行 ， 就 能 使 用 
equalsIgnoreCase 了。 
我 注释 掉 了 第 32 行 和 第 45 行 的 测试 ， 因 为 我 不 太 明 确 是 否 应 该 文 持 
tues 和 thurs 缩 写 。 
第 153 行 和 154 行 的 测试 不 能 通过 。 显 然 ， 它 们 本 该 通过 [G2]。 我 们 
可 以 轻易 地 修正 ， caino i 以 下 修改 惑 行 ， 对 于 第 
163 行 和 213 行 的 测试 也 一 样 。 





457 if ((result< 1) || (result > 12)) { 
result = -1: 

458 for (inti = 0; i< monthNames.length; i++) { 

459 if 
(s.equalsIgnoreCase(shortMonthNames[i])) 1 

460 result=i+ 1; 

461 break; 

462 } 

463 if (s.equalsIgnoreCase(monthNames[i])) 1 

464 result - i^ 1; 

465 break; 

466 j 

467 } 

468 } 

第 318 行 注释 掉 的 测试 暴露 了 getFollowingDayOfWeek 方 法 中 的 一 个 
缺陷 (第 672 行 )。2004 年 12 月 25 日 是 个 周 六 。 下 一 个 周 六 是 2005 年 1 月 


1 日 。 然 而 ， 运 行 测试 时 ， 会 看 到 getFollowingDayOfWeek 返 回 12 月 25 日 
之 后 的 周 六 还 是 12 月 25 日 。 显 然 这 不 对 [G3] ”[T1]。 我 们 看 到 问题 在 第 
685 行 。 那 是 个 典型 的 边界 条 件 错误 [T5]。 应 该 是 这 样 : 

685 if (baseDOW >= targetWeekday) { 





很 有 意思 ， 这 个 函数 是 之 前 一 次 修改 的 结果 。 修 改 记录 (第 43 行 ) 
显示 ，getPreviousDayOfWeek、getFollowingDayOfWeek 和 和 
getNearestDayOfWeek 中 的 “缺陷 ”已 被 修正 [T6]。 

测试 getNearestDayOfWeek (第 705 行 的 单元 测试 
testGetNearestDayOfWeek (232947) 之 前 的 版 本 不 像 现在 一 样 没 有 路 
漏 。 我 添加 了 大 量 测 试用 例 ， 因 为 初始 的 测试 用 例 并 没有 全 部 通过 
[T6]。 查 看 哪些 测试 用 例 被 注释 掉 ， 你 可 以 看 到 失败 的 模式 ， 这 很 有 局 
发 。 如 果 最 近 的 日 期 是 在 未 来 ， 算 法 就 会 失败 。 显 然 存在 某 种 边界 条 件 
错误 [T5]。 

Clover 汇 报 的 测试 履 盖 模式 也 很 有 趣 [T8]。 第 719 行 根本 没有 执行 ! 
这 意味 着 第 718 行 的 证 语句 总 是 得 到 false 的 结果 。 没 错 ， 看 一 眼 代 码 就 知 
道 是 这 样 。 变 量 adjust 总 是 为 负 ， 所 以 不 会 大 于 或 等 于 4。 上 所 以 ， 算 法 错 
Te 

正确 的 算法 如 下 所 示 : 

int delta = targetDOW - base.getDayOfWeek(); 


int positiveDelta = delta + 7; 

















int adjust = positiveDelta % 7; 
if (adjust > 3) 
adjust -= 7; 

return SerialDate.addDays(adjust, base); 

最 后 ， 只 要 简单 地 抛 出 ”也 egalArgumentException 异常 而 不 是 从 
weekInMonthToString 和 relativeToString 返 回 错误 字符 串 ， 第 417 行 和 429 
行 的 测试 也 能 通过 。 

做 出 这 些 修改 后 ， 所 有 的 单元 测试 都 通过 了 ， 我 确信 SerialDate I 
下 可 以 工作 。 是 时 候 让 它 “ 做 对 ”了 。 


16.2 LEE (ie 


我 们 将 从 头 到 尾 遍 历 SerialDate， 同 时 加 以 改进 。 尽 管 在 本 章 的 讨 
论 中 你 看 不 到 这 个 过 程 ， 在 每 次 做 修改 后 ， 我 还 是 要 运行 全 部 JCommon 
单元 测试 ， 包 括 我 为 SerialDate 改 进 的 那些 单元 测试 。 所 以 ， 后 面 你 看 
到 的 所 有 修改 ， 对 于 JCommon 都 是 可 工作 的 。 

从 第 1 行 开始 ， 我 看 到 大 量 有 关 许 可 、 版 权 、 作 者 和 修改 历史 的 注 
释 。 我 明白 ， 的 确 有 些 法 律 事宜 要 说 明 ， 所 以 版 权 和 许可 信息 应 该 保 
留 。 男 外 ， 修 改 历 史 是 产生 于 19 世 纪 60 年 代 的 古董 ， 现 今 源 代码 控制 工 
有 具 可 以 帮 我 们 做 到 这 个 。 应 该 删 掉 修改 历史 [C1]。 

从 第 61 行 开始 的 导入 列表 应 该 通过 使 用 java.text.* 和 java.util.* 来 缩 
短 。[J1] 

Javadoc 的 HTML 格 式 化 工作 (第 67 行 ) 令 我 垦 惧 。 一 个 源 文件 里 面 
有 多 种 语言 ， 我 有 点 发 杀 。 这 条 注释 有 4 种 语言 Java、 类 文 、Javadoc 
和 html[G1]。 有 那么 多 语言 ， 就 很 难 直截了当 。 例 如 ， 生 成 Javadoc 后 ， 
第 71 行 和 72 行 原本 很 好 的 位 置 就 丢失 了 ， 而 且 谁 想 在 源 代码 中 看 到 <ul> 
和 <li> 这 样 的 东西 呢 ? 更 好 的 策略 可 能 是 用 <pre> 标 签 把 整个 注释 部 分 包 
围 起 来 ， 这 样 ， 对 于 源 代码 的 格式 化 只 会 限于 Javadoc 之 内 [1]。 

第 86 行 是 类 声明 。 这 个 类 为 何 要 命名 为 SerialDate? Serial 一 词 有 什 
么 妙 处 吗 ? 是 不 是 因为 该 类 派生 自 Serializable? 看 来 不 是 这 样 的 。 

别 猪 了 ， 我 知道 为 什么 (或 者 我 认为 自己 知道 ) 何以 要 用 Serial 一 
词 。 线 索 束 在 位 于 第 98 行 和 101 行 的 常量 SERIAL LOWER BOUND 和 
SERIAL UPPER BOUND。 更 好 的 线索 在 从 第 830 行 开始 的 注释 中 。 该 类 
被 命名 为 SerialDate， 是 因为 它 用 “序列 数 ”(serial number) 来 实现 ， 访 














系列 数 恰好 是 从 1899 年 12 月 30 日 后 的 天 数 。 

对 此 我 有 两 个 问题 。 首 先 ， 术 语 “ 序 列 数 ? 并 不 真 对 。 可 能 有 点 诡 
辩 ， 但 其 呈现 方式 却 更 接近 相对 偏 移 甚 于 序列 数 。 术 语 “ 序 列 数 ” 更 多 地 
用 于 产品 版 本 标识 ， 而 非 日 期 标识 。 我 没 发 现 这 个 名 称 特别 有 描述 力 
[N1]。 更 有 描述 力 的 术语 大 概 是 “顺序 ”(ordinal ) 。 

第 二 个 问题 更 突出 。 名 称 SerialDate 暗示 了 一 种 实现 。 该 类 是 个 抽 
象 类 。 没 必要 暗示 任何 有 关 实 现 的 事 。 实 际 上 ， 没 理由 隐藏 实现 ! 我 发 
现 这 个 名 称 放 在 了 不 正确 的 抽象 层级 上 [N21]。 以 我 之 见 ， 该 类 的 名 称 应 
该 就 是 简单 的 Date。 

不 对 的 是 ，Java 类 库 里 面 有 太 多 叫 Date 的 类 了 ， 上 所 以 这 大 概 也 不 是 
最 好 的 名 称 。 因 为 这 个 类 是 关于 日 期 而 非 时 间 ， 我 想 将 其 命名 为 Day， 
但 这 个 名 字 也 在 多 处 被 渴 用 。 最 后 ， 我 选 了 DayDate 作 为 最 佳 折衷 方 


案 。 





























从 现在 起 ， 我 将 使 用 术语 DayDate。 请 记 住 ， 你 读 到 的 代码 清单 ， 
还 是 用 的 SerialDate。 
我 理解 为 何 DayDate 继承 自 Comparable 和 Serializable。 不 过 ， 为 什 
么 它 要 继承 自 MonthConstants 呢 ? 类 MonthConstants〈 见 代码 清单 B-3) 
只 是 一 大 堆 定义 了 月 份 的 静态 常量 。 从 常量 类 继承 是 Java 程 序 员 用 的 一 
种 老 花 招 ， 这 样 他 们 就 能 避免 形 如 MonthConstants.January 的 表达 式 ， 不 
过 这 是 个 坏 主意 [J2]。MonthConstants 其 实 应 该 是 个 枚 举 。 
public abstract class DayDate implements Comparable, 
Serializable { 
public static enum Month { 
JANUARY(1), 
FEBRUARY(2), 
MARCH(3), 
APRIL(4), 


MAY(5), 
JUNE(6), 
JUL Y(7), 
AUGUST(8), 
SEPTEMBER(9), 
OCTOBER(10), 
NOVEMBER(11), 
DECEMBER(12); 
Month(int index) { 

this.index = index; 
} 
public static Month make(int monthIndex) { 
for (Month m : Month.values()) { 

if (m.index == monthIndex) 

return m; 
} 
throw new IllegalArgumentException("Invalid month index " + 
monthIndex); 

public final int index; 
} 

} 

把 MonthConstants 改 成 枚 举 ， 导 致 对 DayDate 类 和 用 到 这 个 类 的 代码 
的 一 些 修改 。 我 花 了 一 个 小 时 来 改 代码 。 不 过 ， 原 来 以 int 为 月 份 类 型 的 
函数， 现在 都 用 上 Month 枚 举 元 素 了 。 这 意味 着 我 们 可 以 去 除 
isValidMonthCode 方 法 (第 326 行 ) ， 以 及 monthCodeToQuarter 等 位 置 的 
月 份 代码 错误 检查 《第 356 行 ) 了 [G5]。 

下 一 步 ， 我 们 看 到 第 91 行 ，serialVersionUID 。 该 变量 用 于 控制 序列 





写 。 如 果 我 们 修改 了 它 ， 用 这 个 软件 编写 的 旧版 本 DayDate 都 将 不 再 可 
用 ， 而 是 返回 一 个 InvalidClassException 异 常 。 如 果 你 没有 声明 
serialVersionUID 变 量 ， 则 编译 器 会 自动 生成 一 个 ， 每 次 修改 模块 时 都 会 
得 到 不 一 样 的 值 。 我 知道 ， 所 有 的 文档 都 建议 手工 控制 这 个 变量 ， 但 对 
我 来 说 自动 控制 序列 号 安全 得 多 [G4]。 我 宁肯 调试 
InvalidClassException， 也 不 愿意 见 到 如 果 环 记 修改 serialVersionUID 引 起 
的 后 续 工 作 。 所 以 ， 我 要 删除 这 个 变量 一 一 至 少 暂 时 这 么 做 [2]。 

我 发 现 第 93 行 的 注释 是 多 余 的 。 这 正 是 谋 言 和 误导 信息 所 在 之 地 
[C2]。 所 以 我 要 干掉 它 和 它 的 同类 。 

第 97 行 和 100 行 的 注释 有 关 序 列 数 ， 我 之 前 已 经 讨论 过 这 个 问题 
[C1]。 它 们 摘 述 的 变量 是 DayDate 能 够 摘 述 的 最 早 和 最 后 的 日 期 。 这 可 
以 搞 得 更 清楚 些 [N1]。 

public static final int EARLIEST_DATE_ORDINAL = 2; // 1/1/1900 

public static final int LATEST DATE ORDINAL = 2958465; // 
12/31/9999 

我 不 太 清楚 为 什么 EARLIEST_DATE_ORDINAL 是 2 而 不 是 0。 在 第 
829 行 的 注释 中 有 个 提示 ， 说 明 这 与 用 Microsoft Excel 展 示 日 期 的 方式 有 
关 。 在 DayDate 的 派生 类 SpredsheetDate 中 能 看 得 更 深入 〔 见 代码 清单 B- 
5) 。 第 71 行 的 注释 很 好 地 描述 了 这 个 问题 。 

我 的 问题 是 ， 这 看 来 应 该 与 SpreadsheetDate 有 关 ， 与 DayDate 无 关 
才 对 。 所 以 ，EARLIEST_DATE_ORDINAL 和 
LATEST DATE_ORDINAL 实 在 不 该 属于 DayDate， 应 该 移 到 
SpreadSheeDate 中 [G6]。 

的 确 ， 搜 索 一 下 代码 就 知道 ， 这 些 变量 值 仅 在 SpreadSheetDate 中 用 
到 。DayDate 中 没 用 到 ，JCommon 框 架 的 其 他 类 中 也 没有 用 。 上 所以， 我 
将 把 它们 辐 下 移 到 SpreadSheetDate 中 。 

下 面 两 个 变量 ，MINIMUN_YEAR_SUPPORTED 和 























MAXIMUM YEAR SUPPORTED (210447 #110747) Hifi. 5E 
然 ， 如 果 DayDate 是 个 没有 提供 实现 铺垫 的 抽象 类 ， 它 就 不 该 告知 我 们 
有 关 最 小 和 最 大 年 份 的 信息 。 同 样 ， 我 很 想 把 这 些 变 量 同 下 移 到 
SpreadSheetDate 中 [G6]。 然 而 ， 快 速 查 找 这 些 变量 的 使 用 情况 ， 会 发 现 
男 一 个 类 也 在 用 : RelativeDayOfWeekRule ”〈 见 代码 清单 B-6) 。 在 第 
177 行 和 178 行 ，getDate 函 数 中 ， 它 们 被 用 来 检查 getDate 的 年 份 参数 是 
人 否 有 效 。 抽 象 类 的 用 户 需 要 得 知 其 实现 信息 ， 这 是 个 矛盾 。 

我 们 要 做 的 是 既 提 供 信 息 ， 又 不 污染 DayDate. 38$, RITEM 
生 类 实体 中 获取 实现 信息 。 不 过 ， 并 未 同 getDate 函数 传 入 DayDate 的 实 
体 ， 反 而 返回 了 这 么 一 个 实体 。 这 意味 着 必须 在 某 处 创建 实体 。 第 187 
一 205 行 提供 了 线索 。DayDate 实 体 是 在 getPreviousDayOfWeek、 
getNearestDayOfWeek 或 getFollowingDayOfWeek 这 三 个 函数 其 中 之 一 
里 面 创 建 的 。 看 回 DayDate 代 码 清 单 ， 我 们 看 到 ， 这 些 函 数 《〈 第 638 一 
724 行 ) 全 都 返回 了 由 addDays〈 第 571 行 ) 创建 的 日 期 实体 ，addDays 调 
用 CreateInstance (2580847) , ， 创 建 出 一 个 SpreadSheetDate! [G7]. 

通常 来 说 ， 基 类 不 宜 了 解 其 派生 类 的 情况 。 为 了 修正 这 个 毛病 ， 我 
们 应 该 利用 抽象 工厂 模式 (ABSTRACT FACTORY) [3]， 创建 一 个 
DayDateFactory。 该 工厂 将 创建 我 们 所 需要 的 DayDate 的 实体 ， 并 回答 有 
关 实 现 的 问题 ， 例 如 最 大 和 最 小 日 期 之 类 。 

public abstract class DayDateFactory { 








private static DayDateFactory factory = new 
SpreadsheetDateFactory(); 
public static void setInstance(DayDateFactory factory) { 
DayDateFactory.factory = factory; 
} 
protected abstract DayDate _makeDate(int ordinal); 
protected abstract DayDate _makeDate(int day, DayDate.Month 


month, int year); 
protected abstract DayDate _makeDate(int day, int month, int year); 
protected abstract DayDate _makeDate(java.util.Date date); 
protected abstract int. getMinimumY ear(); 
protected abstract int. getMaximumY ear(); 
public static DayDate makeDate(int ordinal) 1 
return factory. makeDate(ordinal); 
j 
public static DayDate makeDate(int day, DayDate.Month month, int 
year) 1 
return factory. makeDate(day, month, year); 
j 
public static DayDate makeDate(int day, int month, int year) 1 
return factory. makeDate(day, month, year); 
j 
public static DayDate makeDate(java.util.Date date) 1 
return factory. makeDate(date); 
j 
public static int getMinimumYear() 1 
return factory. getMinimumYear(); 
j 
public static int getMaximumYear() 1 


return factory. getMaximumY ear(); 


} 
该 工厂 类 用 makeDate 方 法 蔡 代 了 createInstance 方 法 ， 前 者 的 名 称 稍 
好 一 些 [N1]。 在 初始 状态 下 ， 它 使 用 SpreadsheetDateFactory， 但 随时 可 


以 使 用 其 他 工厂 。 委 托 到 抽象 方法 的 静态 方法 混合 采用 了 单 件 模式 
(SINGLETON) 、 油 洪 工 模式 [和 抽象 工矿 模式 551]， 我 发 现 这 种 手段 
很 有 用 。 
SpreadsheetDateFactory 看 起 来 像 这 个 样子 : 
public class SpreadsheetDateFactory extends DayDateFactory { 
public DayDate _makeDate(int ordinal) { 
return new SpreadsheetDate(ordinal); 
} 
public DayDate _makeDate(int day, DayDate.Month month, int year) 


return new SpreadsheetDate(day, month, year); 
} 
public DayDate _makeDate(int day, int month, int year) { 
return new SpreadsheetDate(day, month, year); 
} 
public DayDate _makeDate(Date date) { 
final GregorianCalendar calendar = new GregorianCalendar(); 
calendar.setTime(date); 
return new SpreadsheetDate( 
calendar.get(Calendar. DATE), 
DayDate.Month.make(calendar.get(Calendar. MONTH) + 1), 
calendar.get(Calendar.Y EAR)); 
j 
protected int getMinimumYear() 1 
return SpreadsheetDate. MINIMUM YEAR, SUPPORTED; 
j 


protected int. getMaximumY ear() 1 


return SpreadsheetDate. MAXIMUM YEAR, SUPPORTED; 
j 

j 

如 你 所 见 ， 我 已 经 把 MINIMUM_YEAR_SUPPORTED 和 
MAXIMUM_YEAR_SUPPORTED 变 量 移 到 了 它们 该 在 的 
SpreadsheetDate 中 [G6]。 

DayDate 的 下 一 个 问题 是 第 109 行 的 日 期 常量 。 这 些 常量 其 实 应 该 是 
枚 举 [J3]。 我 们 之 前 见 过 这 种 模式 ， 不 再 袭 述 。 你 可 以 在 最 终 的 代码 清 
单 中 看 到 。 

跟着 ， 我 们 看 到 第 140 行 一 系列 以 LAST_DAY_OF_MONTH 开 头 的 
数组 。 首先 ， 描 述 这 些 数组 的 注释 全 属 多 余 [C3]。 光 看 名 称 就 够 了 。 所 
以 我 要 删除 这 些 注释 。 

这 个 数组 没 理 由 不 是 私有 的 [G8]， 因 为 有 个 静态 函数 
lastDayOfMonth 提 供 同样 的 数据 。 

下 一 个 数组 AGGREGATE_DAYS_TO_END_OF_MONTH 更 神秘 一 
些 ， 在 JCommon 框架 中 根本 没 用 到 它 [G9]。 所 以 我 直接 删除 了 。 

X¥}--LEAP_YEAR_ AGGREGATE DAYS TO END OF MONTH, 
一 样 : 

AGGREGATE DAYS TO END OF PRECEDING MONTH H Æ 
SpreadsheetDate 中 用 到 【第 434 行 和 473 行 ) 。 是 否 把 它 移 到 
SpreadsheetDate 中 去 是 个 问题 。 不 转移 的 理由 是 ， 该 数组 并 不 专属 于 任 
何 特定 的 实现 [G6]。 另 一 方面 ， 实 际 上 并 不 存在 SpreadsheetDate 之 外 的 
实现 ， 所 以 ， 数 组 应 该 移 到 靠近 其 使 用 位 置 的 地 方 [G10]。 

说 服 我 的 理由 是 保持 一 致 [G11]， 数 组 应 该 私有 ， 并 通过 类 似 
julianDateOfLastDayOfMonth 这 样 的 函数 来 骏 露 。 看 来 没 人 需要 那样 的 
函数 。 而 且 ， 如 果 有 新 的 DayDate 实 现 需 要 该 数组 ， 可 以 轻易 地 把 它 移 
回 到 DayDate 中 去 。 所 以 我 就 把 它 移 到 SpreadsheetDate 里 面 了 。 








XI TLEAP YEAR AGGREGATE DAYS TO END OF MONTH.t9 
一 样 





跟着 ， 我 们 看 到 三 组 可 以 转换 为 枚 举 的 常量 〈 第 162 一 205 行 ) 。 第 
一 个 用 来 选择 月 份 中 的 一 周 。 我 将 其 转换 为 名 为 WeekInMonth 的 枚 举 。 
public enum WeekInMonth { 

FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 

public final int index; 

WeekInMonth(int index) { 


this.index = index; 


} 

FARE (177-187/7) ARE. INCLUDE NONE. 
INCLUDE_FIRST、INCLUDE_SECOND 和 INCLUDE_BOTH 和 常量 用 于 描 
述 某 个 范围 的 终止 日 是 否 包含 在 该 范围 之 内 。 数 学 上 ， 用 术语 “开放 区 
间 ”、“ 半 开放 区 间 ” 和 “闭合 区 间 ” 来 表示 。 我 想 ， 用 数学 术语 来 命名 会 
更 清晰 [N3]， 所 以 束 将 其 转换 为 枚 举 DateInterval， 其 中 包括 
CLOSED. CLOSED LEFT、CLOSED_RIGHT 和 OPEN 枚 举 元 素 。 

第 三 组 常量 〈 第 18 一 205 行 ) 描述 了 是 否 该 在 最 后 、 下 一 个 或 最 近 
的 日 期 实体 中 呈现 对 某 个 星期 的 特定 一 天 的 查找 结果 。 怎 么 命名 是 个 难 
题 。 最 终 ， 我 给 WeekdayRange 设 定 了 LAST、NEXT 和 NEAREST 枚 举 
TUR e 

你 也 许 不 会 同意 我 取 的 名 字 。 对 我 而 言 这 些 名 字 有 意义 ， 但 对 你 可 
能 束 不 然 。 要 点 是 它们 眼下 变 成 了 易于 修改 的 形式 [J3]。 不 再 以 整数 形 
式 传递 ， 而 是 作为 符号 传递 。 我 可 以 用 IDE 的 “修改 名 称 ”功能 来 改动 名 
称 或 类 型 ， 无 需 担 忧 漏 掉 代码 中 某 处 -1 或 2 之 类 的 数字 ， 也 不 必 担 忧 某 
些 int 参 数 声明 处 于 描述 不 佳 的 状态 。 

第 208 行 的 描述 字段 看 来 没有 任何 地 方 用 到 。 我 把 它 及 其 取 值 器 和 
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我 还 删除 了 第 213 行 的 默认 构造 器 [G12]。 编 译 器 会 为 我 们 自动 生成 
的 。 

略 过 isValidWeekdayCode 方 法 《第 216 一 238 行 ) ， 在 创建 Day 枚 举 
时 已 经 把 它 删 掉 了 。 

于 是 来 到 stringToWeekdayCode 方 法 《第 242 一 270 行 ) 。 没 有 方法 
签名 增添 价值 的 Javadoc 都 是 废话 [C3]、[G12]， 唯 一 的 价值 是 对 返回 值 
一 1 的 描述 。 然 而 ， 因 为 我 们 改 用 了 Day 枚 举 ， 这 条 注释 就 完全 错误 了 
[C2]。 访 方法 现在 抛 出 一 个 IllegalArgumentException 异 常 。 所 以 我 删除 
了 Javadoc。 

我 还 删除 了 参数 和 变量 声明 中 的 全 部 final 关 键 字 。 我 敢 说 ， 它 们 旦 
无 价值 ， 空 自 混 请 视听 惑 [G12]。 删 除 这 些 final， 不 合 某 些 成 例 。 例 
lll, Robert Simmons[6] 就 强烈 建议 我 们 “..….. 在 代码 中 遍布 fnal。” 我 不 
能 且 同 。 我 认为 ，final 有 少数 的 好 用 法 ， 例 如 偶尔 使 用 的 final 常 量 ， 但 
除 此 之 外 该 关键 字 利 小 于 次。 我 这 么 认为 ， 或 许 是 因为 final 可 能 捕获 到 
的 那些 错误 类 型 ， 早 已 被 我 编号 的 单元 测试 捕获 了 。 

我 不 喜欢 for 循 环 《〈 第 259 行 和 263 行 ) 中 的 那些 计 语 名 [G5]， 上 所 以 我 
利用 操作 符 把 它们 连接 为 单个 ff 语句。 我 还 使 用 Day 枚 举 整 理 for 循 
环 ， 做 了 一 些 装 饰 性 的 修改 。 

我 认为 ， 这 个 方法 并 不 真 属于 DayDate 类 。 它 其 实 是 Day 的 一 个 解 
析 函 数 。 所 以 ， 我 将 它 移 到 Day 枚 举 中 。 不 过 ， 那 样 Day 枚 举 就 会 变 得 
太 大 。 因 为 Day 的 概念 并 不 依赖 于 DayDate， 我 就 把 Day 枚 举 移 到 
DayDate 类 之 外 ， 放 到 它 自 己 的 源 代码 文件 中 。 

我 还 把 下 一 个 函数 ，weekdayCodeToString (#272—28617) , # 
植 到 Day 枚 举 中 ， 称 其 为 toString。 

public enum Day { 

MONDAY(Calendar.MONDA Y), 





TUESDAY(Calendar. TUESDAY), 
WEDNESDAY (Calendar. WEDNESDA Y),s 
THURSDAY(Calendar. THURSDAY), 
FRIDAY (Calendar.FRIDA Y), 
SATURDAY (Calendar. SATURDAY), 
SUNDAY (Calendar.SUNDA Y); 
public final int index; 
private static  DateFormatSymbols — datesymbols = new 
DateFormatSymbols(); 
Day(int day) 1 
index = day; 
j 
public static Day make(int index) throws IllegalArgumentException 1 
for (Day d : Day.values()) 
if (d.index == index) 
return d; 
throw new IllegalArgumentException( 
String.format("Illegal day index: 96d.", index)); 
j 
public static Day parse(String s) throws Illegal ArgumentException 1 
String[] shortWeekdayNames = 
dateSymbols.getShortWeekdays(); 
String[] weekDayNames = 
dateSymbols.getWeekdays(); 
s = s.trim(); 
for (Day day : Day.values()) { 
if (s.equalsIgnoreCase(shortWeekdayNames[day.index |) || 


s.equalsIgnoreCase(weekDayNames[day.index])) { 
return day; 
} 
} 
throw new Illegal ArgumentException( 
String.format("%s is not a valid weekday string", s)); 
} 
public String toString() { 
return dateSymbols.getWeekdays()[index]; 


} 

Xi /NgetMonth}KW ($288—31647) 。 第 一 个 函数 调用 第 二 个 
数 。 第 二 个 函数 只 被 第 一 个 函数 调用 。 所 以 ， oe 
一 ， 而 且 极 大 地 简化 之 [G9][G12][F4]。 最 后 ， 我 把 名 称 修改 得 更 具 自 我 
描述 力 [N1]。 

public static String[] get MonthNames() { 

return dateFormatSymbols.getMonths(); 

} 

由 于 有 了 Month 枚 举 ， 函 数 isValidMonthCode〈 第 326 一 346 行 ) 就 
变 得 没什么 用 ， 所 以 我 把 它 删 除了 [G9]。 

函数 monthCodeToQuarter (%356~37547) 有 特性 依恋 
(FEATURE ENVY) 四 ] 的 味道 ， 可 以 是 Month 枚 举 中 的 一 个 名 为 quarter 
TTI, KARAM T o 

public int quarter() { 

return 1 + (index-1)/3; 


这 样 一 来 ，Month 枚 举 就 大 到 需要 放 到 目 己 的 类 中 了 。 我 把 它 从 


DayDate 中 移出 来 ， 与 Day 枚 举 保持 一 致 [G11][G13]。 

下 两 个 方法 被 命名 为 monthCodeToString 〈 第 377 一 426 行 ) 。 我 们 
再 次 看 到 其 中 一 个 方法 使 用 标识 调用 其 兄弟 方法 的 模式 。 将 标识 作为 参 
数 传递 给 函数 的 做 法 通常 不 太 好 ， 尤 其 是 当 该 标识 只 是 有 关 其 输出 格式 
时 [G15]。 我 重 命名 、 简 化 、 重 新 构架 了 这 些 函 数 ， 并 把 它们 移 到 Month 
枚 举 中 [N1][N3][G14]。 

public String toString() { 





return dateFormatSymbols.getMonths()[index - 1]; 
} 
public String toShortString() { 
return dateFormatSymbols.getShortMonths()[index - 1]; 
} 
下 一 个 方法 是 stringToMonthCode (#428—47217) 。 我 重新 为 它 命 
名 ， 转 移 到 Month 枚 举 中 ， 并 且 简化 之 [NI1][N3][C3][G14][G12]。 
public static Month parse(String s) { 
s = s.trim(); 
for (Month m : Month.values()) 
if (m.matches(s)) 
return m; 
try 1 
return make(Integer.parseInt(s)); 
j 
catch (NumberFormatException e) 1] 
throw new IllegalArgumentException(" Invalid month " + s); 
j 
private boolean matches(String s) 1 


return s.equalsIgnoreCase(toString()) || 


s.equalsIgnoreCase(toShortString()); 


j 
方法 isLeapYear (38495~51747) 可 以 写 得 更 具 表 达 力 一 些 [G16]。 


public static boolean isLeapYear(int year) 1 





boolean fourth = year 96 4 == 0; 
boolean hundredth = year 96 100 == 0; 
boolean fourHundredth = year 96 400 == 0; 
return fourth && (!hundredth || fourHundredth); 
j 
下 一 个 函数 leapYearCount〈 第 519 一 536 行 ) 并 不 真 属于 DayDate。 
除了 SpreadsheetDate 中 的 两 个 方法 外 ， 没 有 其 他 调用 者 。 所 以 我 将 它 往 
T. 
函数 lastDayOfMonth 〈 第 538 一 560 行 ) 使 用 了 
LAST DAY OF MONTH 数 组 。 该 数组 应 该 未 属于 Month 枚 举 [G17]， 
所 以 我 就 把 它 移 到 那儿 去 了 。 我 还 简化 了 这 个 函数 ， 使 其 更 具 表 达 力 
[G16]. 
public static int lastDayOfMonth(Month month, int year) { 
if (month == Month. FEBRUARY && isLeapYear(year)) 
return month.lastDay() + 1; 
else 
return month.lastDay(); 
} 
现在 ， 事 情 变 得 比较 有 趣 一 些 了 。 下 一 个 函数 是 addDays《〈 第 562 一 
576 行 ) 。 首 先 ， 由 于 该 函数 对 ”DayDate 的 变量 进行 操作 ， 它 就 不 该 是 
议 态 的 [G18]。 所 以 ， 我 把 它 修 改 为 实体 方法 。 其 次 ， 它 调用 了 函数 
toSerial。 这 个 函数 应 该 重新 命名 为 toOrdial [N1]。 最 后 ， 该 方法 可 以 简 
Me 





public DayDate addDays(int days) { 
return DayDateFactory.makeDate(toOrdinal() + days); 

} 

对 于 addMonth《〈 第 578 一 602 行 ) 也 一 样 。 它 应 该 是 个 实体 方法 
[G18]。 算 法 太 过 复杂 ， 上 所 以 我 利用 解释 临时 变量 模式 〈EXPLAINING 
TEMPORARY VARIABLES) [8] 来 使 其 更 为 透明 。 我 还 将 方法 getYYY 
重 命 名 为 getYear [N1]. 

public DayDate addMonths(int months) { 

int thisMonthAsOrdinal = 12 * getYear() + getMonth().index - 1; 
int resultMonthAsOrdinal = thisMonthAsOrdinal + months; 





int resultYear = resultMonth AsOrdinal / 12; 
Month resultMonth = Month.make(resultMonthAsOrdinal % 12 + 1); 


int lastDayOfResultMonth = . lastDayOfMonth(resultMonth, 
result Y ear); 

int resultDay = Math.min(getDayOfMonth(), 
lastDayOfResultMonth); 

return DayDateFactory.makeDate(resultDay, resultMonth, 
resultYear); 


} 
对 于 函数 addYear (#604—62647) 也 照 方 办 理 。 
public DayDate plusYears(int years) { 
int resultYear = getYear() + years; 
int lastDayOfMonthInResultYear = lastDayOfMonth(getMonth(), 
resultYear); 
int resultDay = Math.min(getDayOfMonth(), 
lastDayOfMonthInResultYear); 
return DayDateFactory.makeDate(resultDay, getMonth(), resultYear); 


} 

把 这 些 方法 从 静态 方法 变 为 实体 方法 ， 让 我 有 点 心头 发 痒 。 用 
date.addDays(5) 这 样 的 表达 方法 ， 是 不 是 明确 地 表示 了 date 对 象 并 没 变 
动 以 及 返回 了 一 个 DayDate 的 新 实体 呢 ? 或 者 ， 它 只 是 错误 地 暗示 我 们 
往 date 对 象 添加 了 5 天 呢 ? 你 可 能 不 会 认为 这 是 个 大 问题 ， 但 下 列 代码 却 
可 能 会 有 欺骗 性 。 

DayDate date = DateFactory.makeDate(5, Month.DECEMBER, 1952); 

date.addDays(7); // bump date by one week. 

有 些 读 到 这 段 代 码 的 人 会 认为 addDays 在 修改 date 对 象 。 所 以 ， 我 们 
需要 消除 这 种 卜 义 的 名 称 [N4]。 我 把 名 称 改 为 plusDays 和 plusMonths。 
我 认为 ， 方 法 的 初衷 很 清楚 地 被 

DayDate date = oldDate.plusDays(5); 

所 体现 ， 不 过 下 列 代码 对 认为 date 对 象 被 修改 的 读者 来 说 ， 看 起 来 
并 不 那么 顺畅 : 

date.plusDays(5); 

算法 越 来 越 有 趣 ，getPreviousDayOfWeek (#628—66017) 可 以 工 
作 ， 不 过 有 点 复杂 了。 经 过 一 番 思 考 ， 了 解 到 它 的 功能 后 [G21]， 我 就 
能 够 使 用 解释 临时 变量 模式 来 简化 它 [G19]， 使 其 更 为 清晰 。 我 还 将 它 
从 静态 方法 改 为 实体 方法 [G18]， 并 删除 了 重复 的 实体 方法 [G5]《〈 第 997 
一 1008 行 ) 。 

public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 




















int offsetToTarget = targetDayOfWeek.index - 
getDayOfWeek().index; 
if (offsetToTarget >= 0) 
offsetToTarget -= 7; 
return plusDays(offsetToTarget); 


XtgetFollowingDayOfWeek (&662—69347) 也 如 法 炮制 : 
public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget = targetDayOfWeek.index - 
getDayOfWeek().index; 
if (offsetToTarget <= 0) 
offsetToTarget += 7; 
return plusDays(offsetToTarget); 

} 

下 一 个 函数 是 我 们 之 前 修改 过 的 getNearestDayOfWeek〈 第 695 一 
726 行 )。 我 之 前 所 做 的 修改 和 前 两 个 函数 没有 保持 一 致 [G11]。 所 以 我 
将 它 改 得 和 这 两 个 图 数 保持 一 致 ， 并 且 使 用 解释 临时 变量 模式 [G19] 来 
阐明 算法 。 

public DayDate getNearestDayOfWeek(final Day targetDay) { 

int offsetToThisWeeksTarget = targetDay.index - 
getDayOfWeek().index; 
int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) % 7; 
int offsetToPreviousTarget = offsetToFutureTarget - 7; 
if (offsetToFutureTarget > 3) 
return plusDays(offsetToPreviousTarget); 
else 
return plusDays(offsetToFutureTarget); 

} 

方法 getEndOfCurrentMonth (:28728— 74041) 有 点 奇怪 ， 因 为 它 获 
取 了 DayDate 参 数 ， 从 而 成 为 一 个 依恋 [G14] 其 自身 类 的 实体 方法 。 我 将 
其 改 为 真正 的 实体 方法 ， 并 修改 了 几 个 名 称 。 

public DayDate getEndOfMonth() { 

Month month = getMonth(); 





int year = getYear(); 
int lastDay = lastDayOfMonth(month, year); 
return DayDateFactory.makeDate(lastDay, month, year); 
} 
TE #JweekInMonthToString (2742~76147 ) 的 过 程 非常 有 趣 。 利 用 
IDE 的 重 构 工 具 ， 我 先 将 其 移 到 我 之 前 创建 的 WeekInMonth 枚 举 中 ， 再 
将 其 重 命 名 为 toString。 跟 着 ， 我 把 它 从 静态 方法 改 为 实体 方法 。 所 有 
的 测试 都 通过 了 。 《你 能 猜 出 来 我 打算 做 什么 吗 ? ) 
接 下 来 ， 我 删 掉 了 整个 方法 ! 有 5 个 断言 失败 了 《第 411 一 415 行 ， 
代码 清单 B-4) 。 我 改动 了 这 些 代 人 码 行 ， 让 它们 使 用 枚 举 元 素 的 名 称 
(FIRST, SECOND......) 。 全 部 测试 都 通过 了 。 你 知道 为 什么 吗 ? 你 
能 侣 知道 为 什么 这 些 步 又 都 是 必要 的 吗 ? 重 构 工 具 确保 之 前 对 
weekInMonthToString 方 法 的 调用 现在 都 调用 weekInMonth 枚 举 元 素 的 
toString 方 法 ， 全 部 枚 举 元 素 都 以 返回 其 名 称 的 形式 实现 了 toString 方 


我 不 季 有 点 聪明 过 头 了 。 这 一 套 美 妙 的 重 构 下 来 ， 我 终于 意识 到 ， 
这 个 函数 的 唯一 调用 者 ， 就 是 我 刚 修改 的 测试 ， 所 以 我 删除 了 这 些 测 
Po 

RRK, ÆRA RRAK, ERLA! 所 以 ， 在 判定 除了 测 
试 之 外 没有 人 调用 过 relativeToString 〈 第 765 一 781 行 ) 后， 我 就 删除 了 
该 函数 及 其 测试 。 

我 们 最 后 将 其 改 为 这 个 抽象 类 的 抽象 方法 。 第 一 个 函数 保持 了 原 
FÉ: toSerial〈 第 838 一 844 行 ) 。 前 文 我 曾 把 名 称 改 为 toOrdinal。 以 现在 
的 情形 看 ， 我 决定 应 该 把 名 称 改 为 getOrdinalDay。 

下 一 个 抽象 方法 是 toDate〈 第 838 一 844 行 ) 。 它 将 DayDate 转 换 为 
java.util.Date。 这 个 方法 为 何 是 抽象 的 ? 查看 其 在 SpreadsheetDate 中 的 实 
现 ( 第 198~~207 行 ， 代 码 清单 B-5，， 可 以 看 到 它 并 不 依赖 于 该 类 的 实 








现 [G6]。 上 所 以 ， 我 把 它 往 上 推 了 。 

方法 getYYYY、getMonth 和 getDayOfMonth 已 经 是 抽象 方法 。 不 
过 ，getDayOfWeek 方 法 是 男 一 个 应 该 从 ”SpreadsheetDate 中 提出 来 的 方 
法 ， 因 为 它 不 依赖 于 DayDate 之 外 的 东西 [G6]。 是 这 样 吗 ? 

仔细 阅读 (第 247 行 ， 代 码 清单 B-5)〉 ， 可 以 发 现 该 算法 暗中 依赖 于 
顺序 日 期 的 起 点 换言之 ， 第 0 天 的 星期 日 数 ) 。 所 以 ， 即 便 该 方法 没 
有 物理 上 的 依赖 ， 也 不 能 移 到 DayDate 中 ， 因 为 它 的 确 有 逻辑 上 的 依 
赖 。 

这 样 的 逻辑 依赖 困扰 了 我 [G22]。 如 果 有 什么 东西 在 逻辑 上 依赖 实 
现 的 话 ， 也 该 有 什么 物理 上 的 依赖 存在 。 我 也 认为 ， 算 法 本 吴 也 该 有 一 
小 部 分 依赖 于 实现 。 

所 以 我 在 DayDate 中 创建 了 一 个 名 为 getDayOfWekForOrdinalZero 的 
抽象 方法 ， 并 在 SpreadsheetDate 中 实现 它 ， 返 回 Day.SATURDAY。 然 后 
我 把 getDayOfWeek 上 移 到 DayDate 中 ， 并 调用 getOrdinalDay 和 
getDayOfWeekForOrdinal Zero。 

public Day getDayOfWeek() { 

Day startingDay = getDayOfWeekForOrdinalZero(); 








int startingOffset = startingDay.index - Day.SUNDAY .index; 
return Day.make((getOrdinalDay() + startingOffset) % 7 + 1); 

} 

顺便 说 一 句 ， 请 仔细 阅读 第 895 一 899 行 的 注释 。 这 样 的 重复 有 必要 
吗 ? 通常 ， 我 会 删除 这 类 注释 。 

下 一 个 方法 是 compare 〈 第 902 一 913 行 ) 。 同 样 ， 该 抽象 方法 是 不 
恰当 的 [G6]。 我 将 其 实现 上 移 到 DayDate。 其 名 称 也 不 足够 有 沟通 意义 
[NT1]。 方 法 实际 上 返回 的 是 自 参 数 日 期 以 来 的 天 数 ， 所 以 我 把 名 称 改 为 
daysSince。 我 还 注意 到 该 方法 没有 测试 ， 束 为 它 编 写 了 测试 。 

下 面 6 个 函数 〈 第 915 一 980 行 ) 全 都 是 应 该 在 DayDate 中 实现 的 抽象 








方法 。 我 把 它们 全 都 从 SpreadsheetDate 中 抽出 来 了 。 
最 后 一 个 函数 isInRange 〈 第 982 一 995 行 ) 也 需要 推 到 上 一 层 并 重 构 
之 。 那 个 switch 语 句 有 点 丑陋 [G23]， 可 以 把 那些 条 件 判 断 移 到 
DateInterval 枚 举 中 去 。 
public enum DateInterval { 
OPEN { 
public boolean isIn(int d, int left, int right) { 
return d > left && d < right; 
} 
}; 
CLOSED_LEFT { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d < right; 
} 
ts 
CLOSED_RIGHT { 
public boolean isIn(int d, int left, int right) { 
return d > left && d <= right; 
} 
ie 
CLOSED { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d <= right; 
} 
tà 
public abstract boolean isIn(int d, int left, int right); 


public boolean isInRange(DayDate di, DayDate d2, DateInterval 

interval) { 
int left = Math.min(d1.getOrdinalDay(), d2.getOrdinalDay()); 
int right = Math.max(d1.getOrdinalDay(), d2.getOrdinalDay()); 
return interval.isIn(getOrdinalDay(), left, right); 

j 

我 们 来 到 了 DayDate 的 末尾 。 现 在 我 们 要 从 头 到 尾 再 过 一 次 ， 看 看 
整个 重 构 过 程 是 怎样 民 好 执行 的 。 

首先 ， 开 端 注释 过 时 已 人 入 ， 我 缩短 并 改进 了 它 [C2]。 

然后 ， 我 把 全 部 枚 举 移 到 它们 自己 的 文件 中 [G12]。 

跟着 ， 我 把 静态 变量 (dateFormatSymbols 〉 和 3 个 静态 方法 

CgetMonthNames、isLeapYear 和 1lastDayOfMonth ) 移 到 名 为 DateUtil 的 
新 类 中 [G6]。 

我 把 那些 抽象 方法 上 移 到 它们 该 在 的 顶层 类 中 [G24]。 

我 把 Month.make 改 为 Month.fromInt ”[N1]， 并 如 法 炮制 所 有 其 他 榴 
举 。 我 还 为 全 部 枚 举 创建 了 toInt( ) 访 问 器 ， 把 index 字 上 段 改 为 私有 。 

在 plusYears 和 plusMonths 中 存在 一 些 有 趣 的 重复 [G5]， 我 通过 抽 离 
出 名 为 correctLastDayOfMonth 的 新 方法 消解 了 重复 ， 使 这 3 个 方法 清晰 
多 了 。 

我 消除 了 魔术 数 1 [G25], ĦMonth.JANUARY.toInt( ) 或 
Day.SUNDAY .toInt( ) 做 了 恰当 的 蔡 换 。 我 在 SpreadsheetDate 上 花 了 点 时 
间 ， 清 理 了 一 下 算法 。 最 终结 果 在 代码 清单 B-7~~ 16 中 。 

有 趣 的 是 ，DayDate 的 代码 履 六 率 降低 到 了 84.9%! 这 并 不 是 因为 测 
试 到 的 功能 减少 了 ， 而 是 因为 该 类 缩减 得 大 多， 导致 少量 未 履 盖 到 的 代 
码 行 拥有 了 更 大 权重 。DayDate 的 53 个 可 执行 语句 中 有 45 个 得 到 测试 履 
Hio ARTE AY RAS TT oo BM UK e 








16.3 小 结 





我 们 再 一 次 遵从 了 重子 军 军 规 。 我 们 签 入 的 代码 ， 要 比 签 出 时 整洁 
了 一 点 。 昌 然 伦 了 乓 时 间 ， 不 过 很 值得 。 测 试 履 盖 率 提升 了 ， 修 改 了 一 
些 缺 隐 ， 代 码 清晰 并 缩短 了 。 后 来 者 有 望 比 我 们 更 容易 地 应 付 这 些 代 
码 。 他 也 有 可 能 把 代码 整理 得 更 干净 些 。 





16.4 文献 


[GOF]: Design Patterns: Elements of Reusable Object Oriented 
Software, Gamma et al., Addison-Wesley, 1996. 

[Simmons04]: Hardcore Java, Robert Simmons;Jr.,O'Reilly,2004. 

[Refactoring]: Refactoring: Improving the Design of Existing Code, 
Martin Fowler et al., Addison-Wesley, 1999. 

[Beck97]: Smalltalk Best Practice Patterns, Kent Beck,Prentice 
Hall,1997. 





Dl: 更 好 的 解决 方案 是 让 Javadoc 不 对 注释 做 格式 化 ， 这 样 注释 在 
代码 和 文档 中 就 会 是 一 种 样式 。 


[21. 原 注 : 本 章 的 好 几 个 审读 者 都 不 这 么 认为 。 他 们 主张 ， 在 开源 框架 
中 ， 手 工控 制 序列 ID 会 比较 好 ， 因 为 较 小 的 修改 不 会 导致 序列 化 后 的 日 
期 无 效 。 这 是 种 中 肯 的 观点 。 然 而 ， 尽 管 会 不 方便 ， 但 失败 就 会 有 个 清 
晰 的 原因 。 必 一 方面 ， 如 果 该 类 的 作者 瑟 记 更 新 序列 ID， 则 失败 模式 束 
会 不 可 预期 ， 而 且 可 能 会 隐藏 得 很 深 。 我 认为 ， 这 个 故事 的 精 艇 在 于 ， 
不 应 该 路 版 本 做 反 序 列 化 处 理 。 


[31. 原 注 : [GOF]. 





[4]. 原 注 : Ibid. 

[51. 原 注 : Ibid. 

[6l. 原 注 : [Simmons04], p. 73. 
[7]. 原 注 : [Refactoring]. 


[8]. 原 注 : [Beck97]. 








Martin Fowler HW Refectoring:Improving the Design of Existing 
Code[1 中 指出 了 许多 不 同 的 “代码 味道 "。 下 面 的 清单 包括 很 多 Martin 
提出 的 味道 ， 还 添加 了 更 多 我 自己 提出 的 ， 也 包括 我 借以 历练 本 业 的 其 
他 珍宝 与 局 发 。 

Tr Erst v MEKSI LAT AP I8] ER £i He HRS Rie, R 
都 问 上 自己 为 什么 要 这 样 改 ， 把 修改 的 原因 写 下 来 。 结 果 就 是 得 到 相当 长 
的 清单 ， 给 出 在 读 代 码 时 让 我 闻 起 来 不 舒服 的 味道 。 

清单 应 按 顺 序 阅 读 ， 并 作为 一 种 参考 来 使 用 。 








17.1 注释 


C1: 不 恰当 的 信息 

让 注释 传达 本 该 更 好 地 在 源 代 码 控制 系统 、 问 题 追 踪 系 统 或 任何 其 
他 记录 系统 中 保存 的 信息 ， 是 不 恰当 的 。 例 如 ， 修 改 历史 记录 只 会 用 大 
量 过 时 而 无 趣 的 文本 搞 乱 源 代码 文件 。 通 常 ， 作 者 、 最 后 修改 时 间 、 
SPR 数 等 元 数据 不 该 在 注释 中 出 现 。 注 释 只 应 该 描述 有 关 代 人 码 和 设计 的 
技术 性 信息 。 

C2: 废弃 的 注释 

过 时 、 无 关 或 不 正确 的 注释 就 是 废弃 的 注释 。 注 释 会 很 快 过 时 。 最 
好 别 编写 将 被 废弃 的 注释 。 如 果 发 现 废弃 的 注释 ， 最 好 尽快 更 新 或 删除 
掉 。 废 痉 的 注释 会 远离 它们 曾经 描述 的 代码 ， 变 成 代码 中 无 天 和 误导 的 
浮 岛 。 

C3: TURE 

如 果 注 释 描 述 的 是 茶 种 充分 自我 描述 了 的 东西 ， 那 么 注释 就 是 多 余 
的 。 例 如 : 

i++; // increment i 

男 一 个 例子 是 除 函 数 签名 之 外 什么 也 没 多 说 (或 少 说 ) 的 


Javadoc: 




















[ee 
* @param sellRequest 
* @retum 
* @throws ManagedComponentException 
ey 


public SellResponse beginSellItem(SellRequest sellRequest) 
throws ManagedComponentException 

注释 应 该 谈 及 代码 自 吴 没 提 到 的 东西 。 

C4: ERNER 

值得 编写 的 注释 ， 也 值得 好 好 写 。 如 果 要 编写 一 条 注释 ， 就 花 时 间 
保证 写 出 最 好 的 注释 。 字 期 句 酌 。 使 用 正确 的 语法 和 拼写 。 别 内 扯 ， 别 
画蛇添足 ， 保 持 简 洛 。 

C5: 注释 挥 的 代码 

看 到 被 注释 掉 的 代码 会 令 我 抓 狂 。 谁 知道 它 有 多 旧 ? 谁 知道 它 有 没 

意义 ? 没 人 会 删除 它 ， 因 为 大 家 都 假设 别人 需要 它 或 是 有 进一步 计 
划 。 

那样 的 代码 就 这 样 腐 人 烂 掉 ， 随 着 时 间 推 移 ， 越 来 越 与 系统 没关系 。 
它 调 用 不 复 存在 的 函数 。 它 使 用 已 改名 的 变量 。 它 遵循 已 被 废弃 的 约 
定 。 它 污染 了 所 属 的 模块 ， 分 散 了 想 要 读 它 的 人 的 注意 力 。 注 释 掉 的 代 
AAU Jg RI. 

看 到 注释 掉 的 代码 ， 就 删除 它 ! 别 担心 ， 源 代 人 码 控制 系统 还 会 记得 
它 。 如 果 有 人 真 的 需要 ， 可 以 签 出 较 前 的 版 本 。 别 被 它 搞 到 死去 活 来 。 




















17.2 环境 


El: 需要 多 步 才能 实现 的 构建 

构建 系统 应 该 是 单 步 的 小 操作 。 不 应 该 从 源 代码 控制 系统 中 一 小 点 
一 小 点 签 出 代码 。 不 应 该 需要 一 系列 神秘 指令 或 环境 依赖 脚本 来 构建 单 
个 元 素 。 不 应 该 四 处 寻找 额外 的 小 JAR、XML ”文件 和 其 他 系统 所 需 的 
杂 物 。 你 应 当 能 够 用 单个 命令 签 出 系统 ， 并 用 单个 指令 构建 它 。 

svn get mySystem 

cd mySystem 

ant all 

E2: 需要 多 步 才能 做 到 的 测试 

你 应 当 能 够 发 出 单个 指令 就 可 以 运行 全 部 单元 测试 。 能 够 运行 全 部 
测试 是 如 此 基础 和 重要 ， 应 该 快速 、 轻 易 和 直截了当 地 做 到 。 


17.3 PRIX 


F1: 过 多 的 参数 

函数 的 参数 量 应 该 少 。 没 参数 最 好 ， 一 个 次 之 ， 两 个 、 三 个 再 次 
之 。 三 个 以 上 的 参数 非常 值得 质疑 ， 应 坚决 避免 。 (参见 前 文 “函数 参 
数 ” 一 节 。) 

F2: 输出 参数 

输出 参数 违反 直觉 。 读 者 期 望 参 数 用 于 输入 而 非 输 出 。 如 果 函 数 非 
要 修改 什么 东西 的 状态 不 可 ， 就 修改 它 所 在 对 象 的 状态 好 了 。 (参见 前 
文 “ 输 出 参数 ”一 季 。) 

F3: 标识 参数 

布尔 值 参数 大 声 宣告 函数 做 了 不 止 一 件 事 。 它 们 令 人 迷惑 ， 应 该 消 
灭 挤 。〔( 参 见 前 文 “标识 参数 ”一 节 。) 

F4: 死 函数 

永 不 被 调用 的 方法 应 该 丢弃 。 保 留 死 代码 纯 属 浪费 。 别 害怕 删除 函 
数 。 记 住 ， 源 代码 控制 系统 还 会 记得 它 。 





17.4 一 般 性 问题 


G1: 一 个 源 文件 中 存在 多 种 语言 

当今 的 现代 编程 环境 允许 在 单个 源 文 件 中 存在 多 种 不 同 语言 。 例 
如 ，Java 源 文件 可 能 还 包括 XML、HTML、YAML、JavaDoc、 英 文 、 
JavaScript 等 语言 。 男 例 ，JSP 文 件 可 能 还 包括 HTML、Java、 标 签 库 语 
法 、 英 文 注释 、Javadoc、XML、JavaScript 等 。 往 好 处 说 是 令 人 迷惑 ， 
往 坏 处 说 就 是 粗心 大 意 、 驶 杂 不 精 。 

理想 的 源 文件 包括 且 只 包括 一 种 语言 。 现 实 上 ， 我 们 可 能 会 不 得 不 
使 用 多 于 一 种 语言 。 但 应 该 尽力 减少 源 文件 中 额外 语言 的 数量 和 范围 。 

G2: 明显 的 行为 未 被 实现 

遵循 “最 小 惊异 原则 ”(The Principle of Least Surprise) [2], PAEK 
类 应 该 实现 其 他 程序 员 有 理由 期 待 的 行为 。 例 如 ， 考 虑 一 个 将 日 期 名 称 
翻译 为 表示 该 日 期 的 枚 举 的 函数 。 

Day day = DayDate.StringToDay(String dayName); 

我 们 期 望 字符 串 Monday 翻 译 为 DayMONDAY 。 我 们 也 期 望 常用 缩 
写 形 式 也 能 被 翻译 出 来 ， 我 们 还 期 等 函 数 忽 略 大 小 写 。 

如 果 明 显 的 行为 未 被 实现 ， 读 者 和 用 户 就 不 能 再 依靠 他 们 对 函数 名 
称 的 直觉 。 他 们 不 再 信任 原作 者 ， 不 得 不 阅读 代码 细 市 。 

G3: 不 正确 的 边界 行为 

代码 应 该 有 正确 行为 ， 这 话 看 似 明 白 。 问 题 是 我 们 很 少 能 明白 正确 
行为 有 多 复杂 。 开 发 者 常常 写 出 他 们 以 为 能 工作 的 函数 ， 信 和 赖 自 己 的 直 
党 ， 而 不 是 努力 去 证 明代 码 在 所 有 的 角落 和 边界 情形 下 真能 工作 。 

没什么 可 以 将 代 说 小 慎 微 。 每 种 边界 条 件 、 每 种 极端 情形 、 每 个 异 


党 都 代表 了 某 种 可 能 搞 乱 优雅 而 直 白 的 算法 的 东西 。 别 依赖 直觉 。 退 索 
每 种 边界 条 件 ， 并 编写 测试 。 

G4: 忽视 安全 

切 尔 诡 贝 利 核电 站 骨 场 了 ， 因 为 电厂 经 理 一 条 又 一 条 地 忽视 了 安全 
机 制 。 亲 守 安 全 就 不 便于 做 试验 。 结 果 就 是 试验 未 能 运行 ， 全 世界 都 目 
睹 首 个 民用 核电 站 大 灾难 。 

忽视 安全 相当 人 危险。 手工 控制 serialVersionUID 可 能 有 必要 ， 但 总 会 
有 风险 。 关 闭 某 些 编译 器 警告 (或 者 全 部 警告 ! ) 可 能 有 助 于 构建 成 
功 ， 但 也 存在 陷于 无 穷 无 尽 的 调试 的 风险 。 关 闭 失 败 测试 、 告 诉 自 己 过 
后 再 处 理 ， 这 和 假装 刷 信 用 卡 不 用 还 钱 一 样 坏 。 

G5: 重复 

有 一 条 本 书 提 到 的 最 重要 的 规则 之 一 ， 你 应 该 非常 严肃 地 对 待 。 实 
际 上 ， 每 位 编写 有 关 软 件 设计 的 作者 都 提 到 这 条 规则 。Dave Thomas 和 
Andy Hunt 称 之 为 DRY 原 则 (Don’t Repeat Yourself， 别 重复 自己 ) [3]。 
Kent Beck 将 它 列 为 极限 编程 核心 原则 之 一 ， 并 称 之 为 “一 次 ， 也 只 一 
次 ”。Ron Jeffries 将 这 条 规则 列 在 第 二 位 ， 地 位 只 低 于 通过 所 有 测试 。 

每 次 看 到 重复 代码 ， 都 代表 遗漏 了 抽象 。 重复 的 代码 可 能 成 为 子 程 
序 或 干脆 是 另 一 个 类 。 将 重复 代码 有 登 放 进 类 似 的 抽象 ， 增 加 了 你 的 设计 
语言 的 词汇 量 。 其 他 程序 员 可 以 用 到 你 创建 的 抽象 设施 。 编 码 变 得 越 来 
越 快 ， 错 误 越 来 越 少 ， 因 为 你 提升 了 抽象 层级 。 

重复 最 明显 的 形态 是 你 不 断 看 到 明显 一 样 的 代码 ， 就 像 是 某 位 程序 
员 疡 狂 地 用 鼠标 不 断 复 制 粘贴 代码 。 可 以 用 单一 方法 来 苦 代 之 。 

较 隐 蔽 的 形态 是 在 不 同 模块 中 不 断 重 复出 现 、 检 测 同一 组 条 件 的 
Switch/case 或 if/else 链 。 可 以 用 多 态 来 蔡 代 之 。 

更 隐蔽 的 形态 是 采用 类 似 算法 但 具体 代码 行 不 同 的 模块 。 这 也 是 一 
种 重复 ， 可 以 使 用 模板 方法 模式 [4] 或 策略 模式 [5] 来 修正 。 

的 确 ， 过 去 ”15 年 内 出 现 的 多 数 设计 模式 都 是 消除 重复 的 有 名 手 






































段 。 考 德 范 式 〈Codd Normal Forms) 是 消除 数据 库 规 划 中 的 重复 的 策 
Hg. OO 上 自身 也 是 组 织 模块 和 消除 重复 的 策略 。 坚 不 出 奇 ， 结 构 化 编程 
也 是 。 

重点 已 经 在 那里 了 。 尽 可 能 找到 并 消除 重复 。 

G6: 在 错误 的 抽象 层级 上 的 代码 

创建 分 离 较 高 层级 一 般 性 概念 与 较 低层 级 细 市 概念 的 抽象 模型 ， 这 
很 重要 。 有 时， 我 们 创建 抽象 类 来 容纳 较 高 层级 概念 ， 创 建 派生 类 来 容 
纳 较 低 层次 概念 。 这 样 做 的 时 候 ， 需 要 确保 分 离 完 整 。 所 有 较 低 层级 概 
念 放 在 派生 类 中 ， 所 有 较 高 层级 概念 放 在 基 类 中 。 

例如 ， 只 与 细节 实现 有 关 的 常量 、 变 量 或 工具 函数 不 应 该 在 基 类 中 
出 现 。 基 类 应 该 对 这 些 东 西 一 无 所 知 。 

这 条 规则 对 于 源 文件 、 组 件 和 模块 也 适用 。 恨 好 的 软件 设计 要 求 分 
离 位 于 不 同 层 级 的 概念 ， 将 它们 放 到 不 同 容器 中 。 有 时 ， 这 些 容器 是 基 
类 或 派生 类 ， 有 时 是 源 文件 、 模 块 或 组 件 。 无 论 哪 种 情况 ， 分 离 都 要 完 
整 。 较 低层 级 概念 和 较 高 层级 概念 不 应 混杂 在 一 起 。 看 看 下 面 的 代码 : 


public interface Stack { 























Object pop() throws EmptyException; 
void push(Object o) throws FullException; 
double percentFull(); 
class EmptyException extends Exception {} 
class FullException extends Exception {} 
} 
PR percentFull 位 于 错误 的 抽象 层级 。 尺 管 存在 许多 在 其 中 “ 充 
iW" (fullness) 概念 有 意义 的 Stack 的 实现 ， 但 也 有 其 他 不 能 知道 自己 有 
多 满 的 实现 存在 。 所 以 ， 该 函数 最 好 是 放 在 类 似 BoundedStack 之 类 的 派 
生 接 口中 。 
你 或 许 会 认为 ， 如 果 堆 栈 无 边界 ， 实 现 可 以 返回 0。 问 题 是 ， 不 存 





在 真 的 无 边界 的 堆栈 。 你 不 能 真 的 避免 在 做 以 下 检查 时 出 现 
OutOfMemoryException& ?f : 

stack.percentFull() « 50.0. 
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最 难 做 到 的 事 之 一 ， 而 且 一 旦 做 错 也 没有 快捷 的 修复 手段 。 

G7: 基 类 依赖 于 派生 类 

将 概念 分 解 到 基 类 和 派生 类 的 最 普遍 的 原因 是 较 高 层级 基 类 概念 可 
以 不 依赖 于 较 低 层级 派生 类 概念 。 这 样 ， 如 果 看 到 基 类 提 到 派生 类 名 
称 ， 就 可 能 发 现 了 问题 。 通 常 来 说 ， 基 类 对 派生 类 应 该 一 无 所 知 。 

当然 也 有 例外 。 有 了 时， 派生 类 数量 严格 固定 ， 而 基 类 中 拥有 在 派生 
类 之 则 选择 的 代码 。 在 有 限 状 态 机 的 实现 中 这 种 情形 很 多 见 。 然 而 ， 在 
那 种 情况 下 ， 派 生 类 和 基 类 紧密 厢 合 ， 总 是 在 同一 个 jar 文 件 中 部 辕 。 一 
般 情 况 下 ， 我 们 会 想 要 把 派生 类 和 基 类 部 署 到 不 同 的 jar 文 件 中 。 

将 派生 类 和 基 类 部 署 到 不 同 的 jar 文 件 中 ， 确 保 基 类 jar 文 件 对 派生 类 
jar 文 件 的 内 容 一 无 所 知 ， 我 们 天 能 把 系统 部 署 为 分 散 和 独立 的 组 件 。 修 
改 了 这 些 组件 时 ， 不 必 重 新 部 署 基 组 件 束 能 部 署 它 们 。 这 意味 着 修改 产 
生 的 影响 极 大 地 降低 了 ， 而 维护 系统 也 变 得 更 加 简单 。 

G8: 信息 过 多 

设计 良好 的 模块 有 着 非常 小 的 接口 ， 让 你 能 事半功倍 。 设 计 低 和 劣 的 
模块 有 着 广阔、 深入 的 接口 ， 你 不 得 不 事倍功半 。 设 计 民 好 的 接口 并 不 
提供 许多 需要 依靠 的 函数 ， 所 以 耘 合 度 也 较 低 。 设 计 低 劣 的 借口 提供 大 
量 你 必须 调用 的 函数 ， 耦 合 度 较 高 。 

优秀 的 软件 开发 人 员 学 会 限制 类 或 模块 中 暴露 的 接口 数量 。 类 中 的 
方法 越 少 越 好 。 也 数 知道 的 变量 越 少 越 好 。 类 拥有 的 实体 变量 越 少 越 
uo 

隐藏 你 的 数据 。 隐 藏 你 的 工具 函数 。 隐 藏 你 的 常量 和 你 的 临时 变 


















































量 。 不 要 创建 拥有 大 量 方法 或 大 量 实体 变量 的 类 。 不 要 为 子 类 创建 大 量 
受 保护 变量 和 函数 。 尽 力 保持 接口 紧凑 。 通 过 限制 信息 来 控制 耘 合 度 。 

G9: 死 代码 

死 代 码 束 是 不 执行 的 代码 。 可 以 在 检查 不 会 发 生 的 条 件 的 让 语句 体 
中 找到 。 可 以 在 从 不 抛 出 异常 的 try 语 名 的 catch 块 中 找到 。 可 以 在 从 不 
被 调用 的 小 工具 方法 中 找到 ， 也 可 以 在 永 不 会 发 生 的 switch/case 条 件 中 
找到 。 

死 代 码 的 问题 是 过 不 久 它 束 会 发 出 吴 味 。 时 间 越 入 ， 味 道 束 越 酸 
。 这 是 因为 ， 在 设计 改变 时 ， 死 代码 不 会 随 之 更 新 。 它 还 能 通过 编 
， 但 并 不 会 遵循 较 新 的 约定 或 规则 。 它 编写 的 时 候 ， 系 统 是 另 一 番 模 
。 如 果 你 找到 死 代码 ， 就 体面 地 埋葬 它 ， 将 它 从 系统 中 删除 掉 。 
G10: 3f ELA) I 
变量 和 函数 应 该 在 靠近 被 使 用 的 地 方 定义 。 本 地 变量 应 该 正好 在 其 
首次 被 使 用 的 位 置 上 面 声 明 ， 和 慑 直 距 离 要 短 。 本 地 变量 不 该 在 其 被 使 用 
之 处 几 百 行 以 外 声明 。 

私有 函数 应 该 刚好 在 其 首次 被 使 用 的 位 置 下 面 定 义 。 私 有 函数 属于 
整个 类 ， 但 我 们 还 是 要 限制 调用 和 定义 之 间 的 垂直 距离 。 找 个 私有 函 
数 ， 应 该 只 是 从 其 首次 被 使 用 处 往 下 看 一 点 那么 简单 。 

G11: 前 后 不 一 致 

从 一 而 终 。 这 可 以 姐 溯 到 最 小 惊异 原则 。 小 心 选择 约定 ， 一 旦 选 
中 ， 就 小 心 持续 遵循 。 

如 果 在 特定 函数 中 用 名 为 response 的 变量 来 持 有 HttpServletResponse 
对 象 ， 则 在 其 他 用 到 HttpServletResponse 对 象 的 函数 中 也 用 同样 的 变量 
名 。 如 果 将 某 个 方法 命名 为 processVerificationRequest， 则 给 处 理 其 他 请 
求 类 型 的 方法 取 类 似 的 名 字 ， 例 如 processDeletion Request. 

如 此 简单 的 前 后 一 致 ， 一 旦 坚决 贯彻 ， 就 能 让 代码 更 加 易于 阅读 和 
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G12: 混淆 视听 

没有 实现 的 默认 构造 器 有 何 用 处 呢 ? 它 只 会 用 无 意义 的 杂 雁 搞 乱 对 
代码 的 理解 。 没 有 用 到 的 变量 ， 从 不 调用 的 函数 ， 没 有 信息 量 的 注释 ， 
等 每， 这 些 都 是 应 该 移 除 的 废物 。 保 持 源 文件 整洁 ， 良 好 地 组 织 ， 不 被 
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G13: 人 为 耦合 

不 互相 依赖 的 东西 不 该 炎 合 。 例 如 ， 普 通 的 enum 不 应 在 特殊 类 中 
包括 ， 因 为 这 样 一 来 应 用 程序 就 要 了 解 这 些 更 为 特殊 的 类 。 对 于 在 特殊 
类 中 声明 一 般 目 的 的 static 函 数 也 是 如 此 。 

一 般 来 说， 人 为 耘 合 是 指 两 个 没有 直接 目的 之 间 的 模块 的 耦合 。 其 
根源 是 将 变量 、 常 量 或 函数 不 恰当 地 放 在 临时 方便 的 位 置 。 这 是 种 漫 不 
经 心 的 偷懒 行为 。 

化 点 时 间 研 究 应 该 在 什么 地 方 声明 函数 、 和 常量 和 变量 。 不 要 为 了 方 
便 随手 放置 ， 然 后 置之不理 。 

G14: 特性 依恋 

这 是 Martin Fowler 提 出 的 代码 味道 之 一 [6]。 类 的 方法 只 应 对 其 所 属 
类 中 的 变量 和 函数 感 兴趣 ， 不 该 垂青 其 他 类 中 的 变量 和 函数 。 当 方法 通 
过 茶 个 其 他 对 象 的 访问 妖 和 修改 喜来 操作 该 对 象 内 部 数据 ， 则 它 融 依恋 
于 该 对 象 所 属 类 的 范围 。 它 期 望 自己 在 那个 类 里 面 ， 这 样 就 能 直接 访问 
它 操 作 的 变量 。 例 如 : 

public class HourlyPayCalculator { 


























public Money calculateWeeklyPay(HourlyEmployee e) { 
int tenthRate = e.getTenthRate().getPennies(); 
int tenthsWorked = e.getTenthsWorked(); 
int straightTime = Math.min(400, tenthsWorked); 
int overTime = Math.max(0, tenthsWorked - straightTime); 
int straightPay = straightTime * tenthRate; 


int overtimePay = (int)Math.round(overTime*tenthRate*1.5); 


return new Money(straightPay + overtimePay); 


} 
方法 calculateWeeklyPay 伸手 到 HourlyEmployee 对 象 ， 获 取 要 操作 


的 数据 。 方 法 calculateWeeklyPay 依 恋 于 HourlyEmployee 的 作用 范围 。 
它 “ 期 望 ” 自 己 在 HourlyEmployee 中 。 
同样 情况 下 ， 我 们 要 消除 特性 依恋 ， 因 为 它 将 一 个 类 的 内 部 情形 暴 
露 给 了 另外 一 个 类 。 不 过 ， 有 时 特性 依恋 是 种 有 必要 的 恶 行 。 看 下 面 的 
代码 : 
public class HourlyEmployeeReport { 
private HourlyEmployee employee ; 
public HourlyEmployeeReport(HourlyEmployee e) { 
this.employee = e; 
} 
String reportHours() { 
return String.format( 
"Name: %s\tHours:%d.%1d\n", 
employee.getName(), 
employee.getTenthsWorked()/10, 
employee.getTenthsWorked()%10); 


} 

显然 ，reportHours 方 法 依恋 于 HourlyEmployee 类 。 另 一 方面 ， 我 们 
并 不 想 要 HourlyEmployee 得 知 报告 的 格式 。 把 格式 化 字符 串 移 到 
HourlyEmployee 会 破坏 好 几 种 面 癌 对 象 设 计 原 则 世 ]。 它 将 把 
HourlyEmployee 与 报告 的 格式 耦合 起 来 ， 同 该 格式 的 修改 暴露 这 个 类 。 


G15: 选择 算 子 参数 

没有 什么 比 在 函数 调用 末尾 遇 到 一 个 false 参 数 更 为 可 习 的 事情 了 。 
那个 false 是 什么 意思 ? 如 果 它 是 true， 会 有 什么 变化 吗 ? 不 仅 是 一 个 选 
择 算 子 (selector) 参数 的 目的 难以 记 住 ， 每 个 选择 算 子 参数 将 多 个 函数 
绑 到 了 一 起 。 选 择 算 子 参 数 只 是 一 种 避免 把 大 函数 切 分 为 多 个 小 函数 的 
偷懒 做 法 。 考 虑 下 面 这 段 代 码 : 


public int calculateWeeklyPay(boolean overtime) { 








int tenthRate = getTenthRate(); 

int tenthsWorked = getTenthsWorked(); 

int straightTime = Math.min(400, tenthsWorked); 

int overTime = Math.max(0, tenthsWorked - straightTime); 
int straightPay = straightTime * tenthRate; 

double overtimeRate = overtime ? 1.5 : 1.0 * tenthRate; 

int overtimePay = (int)Math.round(overTime*overtimeRate); 
return straightPay + overtimePay; 

} 

当 加 班 时 间 以 一 倍 半 计 算 薪 资 时 ， 用 true 调 用 这 个 函数 ，false 则 表 
DEA: 每 次 用 到 这 个 函数 ， 你 都 得 记 住 calculateWeeklyPay(false) 
表示 什么 ， 这 已 经 足够 糟 灯 了。 但 这 种 函数 真正 的 坏处 在 于 作者 错过 了 
这 样 写 的 机 会 : 

public int straightPay() { 

return getTenthsWorked() * getTenthRate(); 





} 

public int overTimePay() { 
int overTimeTenths = Math.max(0, getTenthsWorked() - 400); 
int overTimePay = overTimeBonus(overTimeTenths); 


return straightPay() + overTimePay; 


} 

private int overTimeBonus(int overTimeTenths) { 

double bonus = 0.5 * getTenthRate() * overTimeTenths; 

return (int) Math.round(bonus); 

} 

当然 ， 选 择 算 子 不 一 定 是 boolean 类型。 可 能 是 枚 举 元 素 、 整 数 或 
任何 一 种 用 于 选择 函数 行为 的 参数 。 使 用 多 个 函数 ， 通 常 优 于 向 单个 函 
数 传递 菜 些 代码 来 选择 函数 行为 。 

G16: HEB 

代码 要 尽 可 能 具有 表达 力 。 联 排 表 达 式 、 匈 牙 利 语 标记 法 和 魔术 数 
都 遮 南 了 作者 的 意图 。 例 如 ， 下 面 是 overTimePay 函 数 可 能 的 一 种 表现 
形式 : 

public int m_otCalc() { 

return iThsWkd * iThsRte + 

(int) Math.round(0.5 * iThsRte * 

Math.max(0, iThsWkd - 400) 

); 

} 

它 既 短小 又 紧凑 ， 但 实际 上 不 可 捉摸 。 值 得 花 时 间 将 代码 的 意图 呈 
现 给 读者 。 

G17: 位 置 错误 的 权 责 

软件 开发 者 做 出 的 最 重要 诀 定 之 一 就 是 在 哪里 放 代码 。 例 如 ，PI 第 
量 放 在 何 处 ? 是 该 在 Math 类 中 吗 ? 或 者 应 该 属于 Trigonometry 类 ? 还 是 
在 Circle 类 ? 

最 小 惊异 原则 在 这 里 起 作用 了。 代码 应 该 放 在 读者 目 然 而 然 期 待 它 
所 在 的 地 方 。PI 常量 应 该 在 出 现在 声明 三 角 函 数 的 地 方 。 
OVERTIME_RATE 常 量 应 该 在 HourlyPayCalculator 类 中 声明 。 




















有 时 ， LL... 我 们 会 放 在 自己 方 
便 而 读者 不 能 随 直觉 找 到 的 地 方 。 例 如 ， 也 许 我 们 需要 打印 出 某 个 雇员 
Li... 我 们 可 以 在 打印 报表 的 代码 中 做 工作 时 间 统 计 ， 
或 者 我 们 可 以 在 接受 工作 时 间 卡 的 代码 中 保留 一 份 工作 时 间 记 录 。 

做 这 个 决定 的 途径 之 一 是 看 函数 名 称 。 比 如 ， 报 表 模 块 有 个 名 为 
getTotalHours 的 函数 。 接 受 时 间 卡 的 模块 有 一 个 saveTimeCard 函 数 。 顾 
名 思 义 ， 哪 个 名 称 上 蜡 示 了 函数 会 计算 总 时 间 呢 ? AE If E We 

显然 ， 对 于 总 时 间 应 该 在 接受 时 间 卡 的 时 候 计 算 而 不 是 在 打印 报表 
时 计算 ， 这 里 面 有 些 性 能 上 的 考量 。 没 问题 ， 但 函数 名 称 应 该 反映 这 种 
考虑 。 例 如 ， 应 该 在 时 间 卡 模块 中 有 个 computeRunningTotalOfHours 函 
数 。 

G18: 不 恰当 的 静态 方法 

Math.max(double a，double) 是 个 民 好 的 静态 方法 。 它 并 不 在 单个 实 
体 上 操作 ;的 确 ， 不 得 不 写 new  Math( ).max(a,b) H Z2a.max(b) KER 
奏 。 那 个 max 用 到 的 全 部 数据 来 自 其 两 个 参数 ， 而 不 是 来 自 <“ 所 属 ? 对 
象 。 而 且 ， 我 们 也 没 机 会 用 到 Math.max 的 多 态 特 征 。 

不 过 ， 我 们 有 时 也 编写 不 该 是 静态 的 静态 方法 。 例 如 : 

HourlyPayCalculator.calculatePay(employee, overtimeRate). 

这 看 起 来 像 是 个 有 道理 的 static 函 数 。 它 并 不 在 任何 特定 对 象 上 操 
作 ， 而 且 从 参数 中 获得 全 部 数据 。 然 而 ， 我 们 却 有 理由 希望 这 个 函数 是 
多 态 的 。 我 们 可 能 希望 为 计算 每 小 时 文 付 工 资 实现 几 种 不 同 算法 ， 例 如 
Hie inal StraightTimeHourlyPayCalculator. ATL, 
在 这 种 情况 下 ， 该 函数 就 不 该 是 静态 的 。 它 该 是 Employee 的 非 静 态 成 员 

函数 。 

通常 应 该 倾 同 于 选用 非 静态 方法 。 如 果 有 疑问 ， 就 是 用 非 静态 函 
数 。 如 果 的 确 需 要 静态 函数 ， 确 保 没 机 会 打算 让 它 有 多 态 行为 。 

G19: 使 用 解释 性 变量 
































Kent BeckfEH E #Smalltalk Best Practice Patterns[81] 和 另 一 部 巨著 
Implementation Patterns 〈 中 译 版 《实现 模式 》) [9] 中 都 写 到 这 个 。 让 
程序 可 读 的 最 有 力 方 法 之 一 束 是 将 计算 过 程 打 散 成 在 用 有 意义 的 单词 命 
名 的 变量 中 放置 的 中 间 值 。 

看 看 来 自 FitNesse 的 这 个 例子 : 

Matcher match = headerPattern.matcher(line); 

if(match.find()) 

{ 

String key = match.group(1); 





String value = match.group(2); 
headers.put(key.toLowerCase(), value); 
} 
解释 性 变量 的 这 种 简单 用 法 ， 说 明了 第 一 个 匹配 组 是 key， 而 第 二 
个 匹配 组 是 value。 
这 事 很 难 做 过 火 。 解 释 性 变量 多 比 少 好 。 只 要 把 计算 过 程 打 散 成 一 
系列 恨 好 命名 的 中 间 值 ， 不 透明 的 模块 就 会 突然 变 得 透明 ， 这 很 值得 注 


G20: 函数 名 称 应 该 表达 其 行为 
看 看 这 行 代码 : 


Date newDate = date.add(5); 

你 会 期 望 它 向 日 期 添加 5 天 吗 ? 或 者 是 5 个 星期 ? 5 个 小 时 ? 该 date 实 
体会 变化 吗 ? 或 者 该 函数 只 是 返回 一 个 新 的 Date 实 体 ， 并 不 改动 旧 的 ? 
从 函数 调用 中 看 不 出 函数 的 行为 。 

如 果 函 数 向 日 期 添加 5 天 并 且 修 改 该 日 期 ， 就 该 命名 为 addDaysTo 或 
increaseByDays。 如 果 函 数 返回 一 个 表示 5 天 后 的 日 期 ， 而 不 修改 日 期 实 
体 ， 就 该 叫做 daysLater 或 daysSince。 

如 果 你 必须 得 看 函数 的 实现 〈 或 文档 ) 才 知 道 它 是 做 什么 的 ， 就 该 

















换个 更 好 的 函数 名 ， 或 者 重新 安排 功能 代码 ， 放 到 有 较 好 名 称 的 函数 
中 。 

G21: 理解 算法 

好 多 可 笑 代 码 的 出 现 ， 是 因为 人 们 没 花 时 间 去 理解 算法 。 他 们 硬 考 
进 足 够 多 的 证 语句 和 标识 ， 从 不 真正 停 下 来 考虑 发 生 了 什么 ， 勉 强 让 系 
统 能 工作 。 

编程 常常 是 一 种 探险 。 你 以 为 自己 知道 某 事 的 正确 算法 ， 然 后 就 卷 
起 袖子 瞎 干 一 气 ， 搞 到 “可 以 工作 ”为 止 。 你 怎么 知道 它 “ 可 以 工作 ”? DI 
为 它 通 过 了 你 能 想到 的 单元 测试 。 这 种 做 法 没 错 。 实 际 上 ， 这 也 是 让 冰 
数 按 你 设想 的 方式 执行 的 唯一 途径 。 不 过 , “可 以 工作 ”周围 的 引号 可 不 
能 一 直 保 留 。 

在 你 认为 自己 完成 某 个 函数 之 前 ， 确 认 自 己 理 解 了 它 是 怎么 工作 
的 。 通 过 全 部 测试 还 不 够 好 。 你 必须 知道 [10] 解 决 方案 是 正确 的 。 

获得 这 种 知识 和 理解 的 最 好 途径 ， 往 往 是 重 构 函 数 ， 得 到 某 种 整洁 
而 足 具 表达 力 、 清 楚 呈 示 如 何 工作 的 东西 。 

G22: 把 逻辑 依赖 改 为 物理 依赖 

如 果菜 个 模块 依赖 于 男 一 个 模块 ， 依 赖 就 该 是 物理 上 的 而 不 是 逻辑 
上 的 。 依 赖 者 模块 不 应 对 被 依赖 者 模块 有 假定 换言之， 逻辑 依赖 )。 
它 应 当 明 确 地 询问 后 者 全 部 信息 。 

例如 ， 想 像 你 在 编写 一 个 打印 出 雇员 工作 时 长 的 纯 文 本 报表 的 函 
数 。 有 个 名 为 HourlyReporter 的 类 把 数据 收集 为 某 种 方便 的 形式 ， 传 递 
到 HourlyReportFormatter 中 ， 再 打印 出 来 。 《如 代码 清单 17-1 所 示 。) 

代码 清单 17-1 HourlyReporter.java 

public class HourlyReporter { 























private HourlyReportFormatter formatter; 
private List<Lineltem> page; 
private final int PAGE_SIZE = 55; 


public HourlyReporter(HourlyReportFormatter formatter) { 
this.formatter = formatter; 
page = new ArrayList<Lineltem>(); 
} 
public void generateReport(List<HourlyEmployee> employees) { 
for (HourlyEmployee e : employees) { 
addLineItemToPage(e); 
if (page.size() == PAGE SIZE) 
printAndClearItemList(); 
} 
if (page.size() > 0) 
printAndClearItemList(); 
} 
private void printAndClearItemList() { 
formatter.format(page); 
page.clear(); 
} 
private void addLineItemToPage(HourlyEmployee e) { 
LineItem item = new Lineltem(); 
item.name = e.getName(); 
item.hours = e.getTenthsWorked() / 10; 
item.tenths = e.getTenthsWorked() 96 10; 
page.add(item); 
j 
public class LineItem 1 
public String name; 


public int hours; 


public int tenths; 
} 

} 

这 上 段 代 码 有 尚未 物理 化 的 逻辑 依赖 。 你 能 指出 来 吗 ? AB ae d c 
PAGE _SIZE。HourlyReporter 为 什么 要 知道 页 面 尺 寸 ? 页 面 尺寸 只 该 是 
HourlyReportFormatter 的 权 贡 。 

PAGE SIZE 在 HourlyReporter 中 声明 ， 代 表 了 一 种 位 置 错误 的 权 贡 
[G17]， 导 致 HourlyReporter 假定 它 知道 页 面 尺 寸 。 这 类 假设 是 一 种 逻辑 
依赖 。HourlyReporter ”依赖 于 HourlyReportFormatter 能 应 付 55 的 页 面 尺 
寸 。 如 果 HourlyReportFormatter 的 某 些 实现 不 能 处 理 这 样 的 尺寸 ， 就 会 
出 错 





可 以 通过 创建 HourlyReport 中 名 为 getMaxPageSize( ) 的 新 方法 来 物 
理化 这 种 依赖 。HourlyReporter 将 调用 这 个 方法 ， 而 不 是 使 用 
PAGE _SIZE 常 量 。 

G23: 用 多 态 替 代 IBElse 或 Switch/Case 

有 了 第 6 章 谈 及 的 主题 ， 这 条 建议 看 似 奇 怪 。 在 那 章 中 ， 我 提出 在 
添加 新 函数 甚 于 添加 新 类 型 的 系统 中 ，switch 语 句 是 恰当 的 。 

首先 ， 多 数 人 使 用 switch 语 多， 因为 它 是 最 直截了当 又 有 力 的 方 
案 ， 而 不 是 因为 它 适合 当前 情形 。 这 给 我 们 的 启发 是 在 使 用 switch 之 
前 ， 先 考虑 使 用 多 态 。 

其 次 ， 函 数 变化 甚 于 类 型 变化 的 情形 相对 罕见 。 每 个 switch 语 句 都 
值得 怀疑 。 

我 使 用 所 谓 “ 单 个 switch” 规 则 : 对 于 给 定 的 选择 类 型 ， 不 应 有 多 于 
一 个 switch 语 句 。 在 那个 switch 语 句 中 的 多 个 case， 必 须 创建 多 态 对 象 ， 
取代 系统 中 其 他 类 似 switch 语 句 。 
G24: 遵循 标准 约定 
每 个 团队 都 应 遵循 基于 通用 行业 规范 的 一 套 编 码 标准 。 编 码 标准 应 














Hi xe be MUZE (Abi See ee, MAAK, MAMRE, CESARE 
括号 ， 等 等 。 团 队 不 应 用 文档 描述 这 些 约 定 ， 因 为 代码 本 身 提供 了 范 
例 。 





团队 中 的 每 个 成 员 都 应 遵循 这 些 约定 。 这 意味 着 每 个 团队 成 员 必 须 
成 熟 到 能 了 解 只 要 全 体 同意 在 何 处 放置 括号 ， 那 么 在 哪里 放置 都 无 关 紧 


要 。 


如 果 你 想 知 道 我 半 循 哪些 约定 ， 可 以 查看 代码 清单 B-7~B-14 中 重 构 
之 后 的 代码 。 

G25: 用 命名 常量 蔡 代 魔术 数 

这 大 概 是 软件 开发 中 最 古老 的 规则 之 一 了 。 我 记得 ， 在 20 世 纪 60 年 
代 介 绍 COBOL、FORTRAN 和 PL/1 的 手册 中 就 读 到 过 。 在 代码 中 出 现 原 

台 形 态 数 字 通 常 来 说 是 坏 现象 。 应 该 用 良好 命名 的 常量 来 隐藏 它 。 

例如 ， 数 字 86400 应 当 藏 在 常量 SECONDS_PER_DAY 后 面 。 如 果 每 
页 打印 55 行 ， 则 常数 55 应 该 藏 在 常量 LINES_PER_PAGE 后 面 。 

有 些 常量 与 非常 具有 自我 解释 能 力 的 代码 协同 工作 时 ， 如 此 易于 识 
列 ， 也 就 不 必 总 是 需要 命名 第 量 来 隐藏 了 了。 例如 : 

double milesWalked = feetWalked/5280.0; 

int dailyPay = hourlyRate * 8; 
































double circumference = radius * Math.PI * 2; 

在 上 例 中 ， 我 们 真 需 要 常量 FEET_PER_MILE、 
WORK_HOURS_PER_DAY 和 TWO 吗 ? 显然 ， 最 后 那个 很 可 笑 。 有 些 
情况 下 ， 常 量 直接 写作 原始 形态 数字 会 更 好 。 你 可 能 会 质疑 
WORK_HOURS_PER_DAY， 因 为 约定 规则 可 能 会 改变 。 另 一 方面 ， 在 
这 里 直接 用 数字 8 读 起 来 很 舒服 ， 也 就 没 必要 非 用 17 个 额外 的 字母 来 加 
重读 者 负担 不 可 。 对 于 FEET_PEFR_MILE， 数 字 5280 众 人 缘 知 ， 意 义 独 
特 ， 即 便 没 有 上 下 文 环 境 ， 读 者 也 能 识别 它 。 

3.141592653589793 之 类 常数 也 众所周知 ， 很 容易 识别 。 不 过 ， 如 


条 直 接 使 用 原始 形式 ， 却 很 有 可 能 出 错 。 每 次 有 人 看 到 
3.141592653589793， 都 会 知道 那 是 VvV 值 ， 从 而 不 会 去 仔细 查看 。〔 你 
发 现 那个 错误 的 数字 了 吗 ? ) 我 们 不 想 要 人 们 使 用 3.14、3.14159 或 
3.142 等 。 所 以 ， 为 我 们 定义 好 Math.PI 是 件 好 事 。 

术语 “魔术 数 ?不 仅 是 说 数字 。 它 泛 指 任何 不 能 目 我 描述 的 符号 。 例 
如 : 

assertEquals(7777, Employee.find("John Doe").employeeNumber()); 

上 列 断 言 中 有 两 个 大 术 数 。 第 一 个 显然 是 777， 它 的 意义 并 不 明 
确 。 第 二 个 魔术 数 是 John Doe， 因 为 其 意图 不 明显 。 

Jon Doe 是 开发 团队 创建 的 测试 数据 中 编号 为 #7777 的 雇员 。 团 队 








中 每 个 成 员 都 知道 ， 当 连接 到 数据 库 时 ， 里 面 已 经 有 数 个 雇员 信息 ， 其 
值 和 属性 都 是 大 家 熟知 的 。 所 以 ， 这 个 测试 应 该 读 作 : 
assertEquals( 


HOURLY EMPLOYEE ID, 
Employee.find(HOURLY EMPLOYEE NAME).employeeNumber() 
G26: 准确 
期 望 某 个 查询 的 第 一 次 匹配 就 是 唯一 匹配 可 能 过 于 天 真 。 用 学 点 数 
表示 货币 几 近 于 犯罪 。 因 为 你 不 想 做 并 发 更 新 束 避 人 免 使 用 锁 和 /或 事务 
管理 往 好 处 说 也 是 一 种 懒 情 行 为 。 在 可 以 用 List 的 时 候 非 要 把 变量 声明 
为 ArrayList 就 过 分 拘束 了 。 把 所 有 变量 设置 为 protected 却 不 够 自律 。 
在 代码 中 做 决定 时 ， 确 认 自 己 足 够 准确 。 明 确 自 己 为 何 要 这 么 做 ， 
如 果 过 到 和 寞 常情 况 如 何 处 理 。 别 懒得 理会 决定 的 准确 性 。 如 果 你 打算 调 
用 可 能 返回 ”null 的 函数 ， 确 认 自 己 检查 了 null 值 。 如 果 查 询 你 认为 是 数 
据 库 中 唯一 的 记录 ， 确 保 代 码 检 查 不 存在 其 他 记录 。 如 果 要 处 理 货 币 数 
据 ， 使 用 整数 [111]， 并 恰当 地 处 理 四 舍 五 入 。 如 果 可 能 有 并 发 更 新 ， 确 
认 你 实现 了 茶 种 锁定 机 制 。 
代码 中 的 含糊 和 不 准确 要 么 是 意见 不 同 的 结果 ， 要 么 源 于 懒 懈 。 无 








论 原因 是 什么 ， 都 要 消除 。 


G27: 结构 其 于 约定 
坚守 结构 其 于 约定 的 设计 决策 。 命 名 约定 很 好 ， 但 却 次 于 强制 性 的 





结构 。 例 如 ， 用 到 民 好 命名 的 枚 举 的 switch/case 要 弱 于 拥有 抽象 方法 的 
基 类 。 没 人 会 被 强迫 每 次 都 以 同样 方式 实现 switchycase 语 句 ， 但 基 类 却 
让 具体 类 必须 实现 所 有 抽象 方法 。 








G28: 封装 条 件 
如 果 没 有 计 或 while 语 句 的 上 下 文 ， 布 尔 逻 辑 就 难以 理解 。 应 该 把 解 


释 了 条 件 意图 的 函数 抽 离 出 来 。 


Ia 


例如 : 

if (shouldBeDeleted(timer)) 

要 好 于 

if (timer.hasExpired() && !timer.isRecurrent()) 

G29: 避免 否定 性 条 件 

侍 定 式 要 比 肯 定式 难 明白 一 些 。 所 以 ， 尺 可 能 将 条 件 表示 为 肯定 形 
例如 : 

if (buffer.shouldCompact()) 

要 好 于 

if ('buffer.shouldNotCompact()) 

G30: 函数 只 该 做 一 件 事 

编写 执行 一 系列 操作 的 包括 多 段 代 码 的 函数 常常 是 诱 人 的 。 这 类 阴 





数 做 了 不 只 一 件 事 ， 应 该 转换 为 多 个 更 小 的 函数 ， 每 个 只 做 一 件 事 。 


例如 : 
public void pay() { 
} 
for (Employee e : employees) { 
if (e.isPayday()) { 


Money pay = e.calculatePay(); 
e.deliverPay(pay); 


} 
XB AE, VIII, MARIA ASI 
资 ， 然 后 文 付 薪水 。 人 代码 可 以 写 得 更 好 ， 如 : 
public void pay() { 











for (Employee e : employees) 
payIfNecessary(e); 
} 
private void payIfNecessary(Employee e) { 
if (e.isPayday()) 
calculateAndDeliverPay(e); 
} 
private void calculateAndDeliverPay(Employee e) { 
Money pay = e.calculatePay(); 
e.deliverPay(pay); 
} 
上 列 每 个 函数 都 只 做 一 件 事 。〔 见 前 文 “只 做 一 件 事 ”一 节 。) 
G31: iic Fr da 
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让 它们 被 调用 的 次 序 显 而 易 见 。 看 下 列 代码 : 
public class MoogDiver { 





Gradient gradient; 
List<Spline> splines; 
public void dive(String reason) { 


saturateGradient(); 


reticulateSplines(); 


diveForMoog(reason); 


} 
=P PRK APR. HA EAA, AAP ER ANE 
的 是 ， 代 码 并 没有 强制 这 种 时 序 耦 合 。 其 他 程序 员 可 以 在 调用 
saturateGradient 之 前 调用 reticulateSplines， 从 而 导致 抛 出 
UnsaturatedGradientException 异 常 。 更 好 的 方式 是 : 
public class MoogDiver { 
Gradient gradient; 
List<Spline> splines; 
public void dive(String reason) { 
Gradient gradient = saturateGradient(); 
List<Spline> splines = reticulateSplines(gradient); 


diveForMoog(splines, reason); 


} 
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个 函数 所 需 的 结果 ， 这 样 一 来 就 没 理由 不 按 顺 序 调用 了 。 

你 可 能 会 抱怨 着 增加 了 函数 的 复杂 度 ， 没 错 ， 不 过 这 点 额外 的 复杂 
度 却 曝露 了 该 种 情况 真正 的 时 序 复杂 性 。 

注意 我 保留 了 那些 实体 变量 。 我 假设 类 中 的 私有 方法 可 能 会 用 到 它 
们 。 即 便 如 此 ， 我 还 是 希望 参数 能 让 时 序 耦 合 变 得 可 见 。 

G32: 别 随意 

构建 代码 需要 理由 ， 而 且 理由 应 与 代码 结构 相 契 合 。 如 果 结 构 显 得 
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会 使 用 它 ， 并 且 遵 循 其 约定 。 例 如 ， 我 最 近 对 FitNesse 做 合并 修改 ， 发 
现 有 位 页 献 者 这 么 做 : 

public class AliasLinkWidget extends ParentWidget 

{ 

} 

public static class VariableExpandingWidgetRoot { 





问题 在 于 ，VariableExpandingWidgetRoot 没 必要 在 AliasLinkWidget 
作用 范围 之 内 。 而 且 ， 其 他 无 关 的 类 也 用 到 
AliasLinkWidget.VariableExpandingWidgetRoot。 这 些 类 没 必 要 了 解 
AliasLinkWidget. 

或 许 那 位 程序 员 只 是 循 例 把 ”VariableExpandingWidgetRoot 7i#' 
AliasWidget 里面， 或 者 他 真 认 为 这 么 做 是 对 的 。 不 管 原因 是 什么 ， 续 
果 都 显得 随心 所 欲 。 不 作为 类 工具 的 公共 类 ， 不 应 该 放 到 其 他 类 里 面 。 
惯例 是 将 它 置 为 public， 并 且 放 在 代码 包 的 顶部 。 

G33: ARID FATE 

边界 条 件 难 以 追踪 。 把 处 理 边界 条 件 的 代码 集中 到 一 处 ， 不 要 散落 
于 代码 中 。 我 们 不 想见 到 四 处 散 见 的 +1 和 一 1 字样 。 看 看 这 个 来 自 FIT 的 
简单 例子 : 

if(level + 1 < tags.length) 

{ 

parts = new Parse(body, tags, level + 1, offset + endTag); 
body = null; 
} 
TER, level + 1 出 现 了 两 次 。 这 是 个 应 该 封装 到 名 为 nextLevel 之 类 








的 变量 中 的 边界 条 件 。 
int nextLevel = level + 1; 
if(nextLevel < tags.length) 
{ 
} 
parts = new Parse(body, tags, nextLevel, offset + endTag); 
body = null; 
G34: 函数 应 该 只 在 一 个 抽象 层级 上 
函数 中 的 语句 应 该 在 同一 抽象 层级 上 ， 该 层级 应 该 是 冰 数 名 所 示 操 
作 的 下 一 层 。 这 可 能 是 最 难 理解 和 遵循 的 局 有 友 。 尽 管 概 念 足够 直 白 ， 人 
们 还 是 很 容易 混 消 抽象 层级 。 例 如 ， 请 看 下 面 来 目 FitNesse 的 例子 : 
public String render() throws Exception 
{ 
} 
StringBuffer html = new StringBuffer("<hr"); 
if(size > 0) 





html.append(" size=\"").append(size + 1).append("\""); 
html.append(">"); 
return html.toString(); 
稍微 研究 一 下 ， 你 融会 看 到 发 生 了 什么 。 该 函数 构建 了 绘制 横贯 页 
面 线条 的 HIML 标 记 。 线 条 局 上 度 在 size 变 量 中 指定 。 
再 看 一 过 。 方 法 混杂 了 至少 两 个 抽象 层级 。 第 一 个 是 横 线 有 尺寸 这 
个 概念 。 第 二 个 是 hr 标记 自身 的 语法 。 这 段 代 码 来 自 FitNesse 的 
HruleWidget 模 块 。 该 模块 检测 一 行 4 个 或 更 多 个 破 折 写 ， 并 将 其 转换 为 
恰当 的 hr 标记 。 破 折 号 越 多 ， 尺 寸 越 大 。 
我 重 构 了 这 段 代 码 。 注 意 ， 我 修改 了 size 字 段 的 名 称 ， 反 映 其 真正 
目的 。 它 表示 额外 破 折 号 的 数量 。 











public String render() throws Exception 
{ 
} 
HtmlTag hr = new HtmlTag("hr"); 
if (extraDashes > 0) 
hr.addAttribute(" size", hrSize(extraDashes)); 
return hr.html(); 
private String hrSize(int height) 
{ 
} 
int hrSize = height + 1; 
return String.format("%d", hrSize); 
这 次 修改 很 好 地 拆 开 了 两 个 抽象 层级 。 函 数 render 只 构造 一 个 hr 标 
记 ， 不 去 管 该 标记 的 HIML 语 法 。 而 HtmlTag 模 块 则 照管 所 有 这 些 及 脏 
的 语法 问题 。 
做 出 修改 时 ， 我 发 现 了 一 处 微小 的 错误 。 原 始 代码 没有 加 上 hr 标 
记 的 结束 斜 线 从 ， 而 XHTML 标 准 要 求 这 样 做 。 换 言 之 ， 代 码 使 用 了 
<hr> 而 不 是 <hr />。) HtmlTag 模 块 很 早 就 改造 成 符合 XHTML 标 准 了 。 
拆 分 不 同 抽 象 层级 是 重 构 的 最 重要 功能 之 一 ， 也 是 最 难 做 的 一 个 。 
以 下 面 的 代码 为 例 。 这 是 我 第 一 次 尝试 拆 分 HruleWidget.rendermethod 中 
的 抽象 层级 的 结果 。 
public String render() throws Exception 
i 
HtmlTag hr = new HtmlTag("hr"); 
if (size > 0) { 
hr.addAttribute("size", ""+(size+1)); 








return hr.html(); 

} 

此 时 ,我 的 目的 是 做 必要 的 拆 分 ， 并 让 测试 通过 。 我 轻易 达到 了 这 
一 目的 ， 但 结果 是 该 函数 仍然 混 淋 了 多 个 抽象 层级 。 此 时 ,混杂 的 层级 
是 hr 标记 的 构建 ， 以 及 size 变量 的 翻译 和 格式 化 。 这 说 明 当 你 俩 抽象 界 
线 拆 解 函数 时 ， 经 常会 挖 出 原本 被 之 前 的 结构 所 掩蔽 的 新 抽象 界线 。 

G35: 在 较 高 层级 放置 可 配置 数据 

如 果 你 有 个 已 知 并 该 在 较 高 抽象 层级 的 默认 常量 或 配置 值 ， 不 要 将 
它 埋 藏 到 较 低层 级 的 函数 中 。 把 它 作 为 较 高 层级 函数 调用 较 低层 级 函数 
时 的 一 个 参数 。 看 看 以 下 来 自 FItNesse 的 代码 : 

public static void main(String[] args) throws Exception 

{ 


Arguments arguments = parseCommandLine(args); 





} 
public class Arguments 
{ 
public static final String DEFAULT. PATH = "."; 
public static final String DEFAULT_ROOT = "FitNesseRoot"; 
public static final int DEFAULT_PORT = 80; 
public static final int DEFAULT_VERSION_DAYS = 14; 


} 

命令 行 参数 在 FitNesse 中 的 第 一 行 可 执行 代码 得 到 解析 。 这 些 参数 
的 默认 值 在 Argument 类 的 顶部 指定 。 你 不 必 到 系统 的 较 低 层级 去 查看 类 
似 的 语句 : 

if (arguments.port == 0) // use 80 by default 








位 于 较 高 层级 的 配置 性 意 量 易 于 修改 。 它 们 辐 下 贯穿 应 用 程序 。 应 
用 程序 的 较 低 层级 并 不 拥有 这 些 常量 的 值 。 

G36: 避免 传递 浏览 

通常 我 们 不 想 让 某 个 模块 了 解 太 多 其 协作 者 的 信息 。 更 具体 地 说 ， 
如 果 A 与 B 协 作 ，B 与 C 协作 ， 我 们 不 想 让 使 用 A 的 模块 了 解 C 的 信息 。 
(例如 ， 我 们 不 想 写 类 似 a.getB( ).getC( ).doSomething( ) 的 代码 。) 
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只 了 解 其 直接 协作 者 ， 不 了 解 束 个 系统 的 游览 图 。 

如 果 有 多 个 模块 使 用 类 似 a.getB( ).getC( ) 这 样 的 语句 形式 ， 就 难以 
修改 设计 和 架构 ， 在 B 和 C 之 间 插 进 一 个 Q。 你 得 找到 a.getB( ).getC( ) 出 
现 的 所 有 地 方 ， 并 将 其 改 为 a.getB( ).getQ( ).getC( )。 系 统 就 此 变 得 缺乏 
RE. KA WER SRA ST ARE AKA EN E. 
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对 象 全 图 ， 搜 寻 我 们 要 调用 的 方法 。 只 要 简单 地 说 : 

myCollaborator.doSomething(). 




















17.5 Java 


JA: 通过 使 用 通配符 避免 过 长 的 导入 清单 

如 果 使 用 了 来 自 同一 程序 包 的 两 个 或 多 个 类 ， 用 以 下 语句 导入 整个 
包 : 

import package.*; 

过 长 的 导入 清单 令 读 者 望而却步 。 我 们 不 想 用 80 行 导入 语句 搞 乱 模 
块 顶部 位 置 。 我 们 想 要 导入 语句 简约 地 列 出 我 们 要 使 用 的 包 。 

指定 导入 包 是 种 硬 依 赖 ， 而 通配符 导入 则 不 是 。 如 果 你 具体 指定 导 
入 某 个 类 ， 该 类 必须 存在 。 但 如 果 你 用 通配符 导入 某 个 包 ， 则 不 需要 存 
在 具体 的 类 。 导 入 语句 只 是 在 搜寻 名 称 时 把 这 个 包 列 入 碍 找 路 径 。 所 
以 ， 这 种 导入 并 未 构成 真正 的 依赖 ， 也 就 让 我 们 的 模块 较 少 耦合 。 

有 时 ， 长 长 的 具体 导入 清单 也 会 有 用 。 例 如 ， 如 果 你 在 处 理 遗 留 下 
来 的 代码 ， 想 要 找 出 需要 为 哪些 类 构造 蔡 吴 类 和 占 位 代码 ， 就 可 以 过 历 
导入 清单 ， 找 出 这 些 类 的 真名 ， 再 恰当 地 放置 占 位 代码 。 不 过 ， 这 种 用 
法 很 罕见 。 而 且 ， 多 数 现代 IDE 人 允许 你 用 一 个 命令 就 把 通配符 导入 语句 
转换 为 指定 导入 清单 。 所 以 ， 即 便 在 处 理 遗 留 代码 时 ， 最 好 也 用 通配符 
导入 。 

通配符 导入 有 时 会 导致 名 称 冲突 和 歧义 。 两 个 同名 但 位 于 不 同 包 中 
的 类 需要 指名 导入 ， 或 至 少 在 使 用 时 指定 名 称 。 这 种 情形 的 确 讨 厌 ， 不 
过 很 罕见 ， 所 以 使 用 通配符 导入 通 向 仍 优 于 指定 名 称 导 入 。 

J2: 不 要 继承 音量 

我 见 过 这 种 情况 好 几 次 ， 它 总 是 让 我 面 露 苦笑 。 某 个 程序 在 接口 中 
放 了 些 常 量 ， 再 通过 继承 结构 来 访问 这 些 和 常量 。 看 看 以 下 代码 : 






































public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 
public Money calculatePay() { 
int straightTime = Math.min(tenthsWorked, 
TENTHS_PER_WEEK); 
int overTime = tenthsWorked - straightTime; 
return new Money( 
hourlyRate * (tenthsWorked + OVERTIME_RATE * overTime) 


y; 


} 
常量 TENTHS_PER_WEEK 和 OVERTIME RATE 来 自 何方 ? 它们 可 
能 来 自 Employee 类 。 来 看 看 : 


public abstract class Employee implements PayrollConstants { 





public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 
} 
不 ， 不 在 那儿 。 不 过 在 哪儿 呢 ? 再 仔细 看 Employee 类 。 它 实现 了 
PayrollConstants 接 口 。 
public interface PayrollConstants { 
public static final int TENTHS_PER_WEEK = 400; 
public static final double OVERTIME_RATE = 1.5; 
} 
Fie HR ASTE! RES IR) Ie m. I 别 利用 继承 欺 
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import static PayrollConstants.*; 
public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 
public Money calculatePay() { 
int straightTime = Math.min(tenthsWorked, 
TENTHS PER, WEEK); 
int overTime = tenthsWorked - straightTime; 
return new Money( 


hourlyRate * (tenthsWorked + OVERTIME RATE * overTime) 
); 


} 
J3: 常量 vs. 枚 举 
现在 enum 已 经 加 入 Java 语 言 (Java 5), DUCHI! 别 再 用 那个 
public static final int 老 花招 。 那 样 做 int 的 意义 就 丧失 了 ， 而 用 enum 则 不 
然 ， 因 为 它们 隶属 于 有 名 称 的 枚 举 。 
而 且 ， 仔 细 研 究 enum 的 语法 。 它 可 以 拥有 方法 和 字段 ， 从 而 成 为 
能 比 int 提 供 更 多 表达 力 和 有 灵活 性 的 强 有 力 工具 。 看 看 以 下 发 薪 代 码 中 的 
不 同 做 法 : 
public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
HourlyPayGrade grade; 
public Money calculatePay() { 
int straightTime = Math.min(tenthsWorked, 


TENTHS_PER_WEEK); 
int overTime = tenthsWorked - straight Time; 
return new Money( 


grade.rate() * (tenthsWorked + OVERTIME_RATE * overTime) 
); 


} 
public enum HourlyPayGrade { 


APPRENTICE { 
public double rate() { 
return 1.0; 
} 


}, 
LEUTENANT_JOURNEYMAN { 


public double rate() { 
return 1.2; 
} 


}, 

JOURNEYMAN { 
public double rate() { 

return 1.5; 

} 

ti 

MASTER { 
public double rate() { 


return 2.0; 


} 
}; 
public abstract double rate(); 


17.6 名 称 


N1: 采用 描述 性 名 称 

不 要 太 快 取 名 。 确 认 名 称 具 有 描述 性 。 记 住 ， 事 物 的 意义 随 着 软件 
的 演化 而 变化 ， 所 以 ， 要 经 常 性 地 重新 估量 名 称 是 人 否 恰 当 。 

这 不 仅 是 一 条 “感觉 良好 式 ” 建 议 。 软 件 中 的 名 称 对 于 软件 可 读 性 有 
90% 的 作用 。 你 要 花 时 间 明 智 地 取 名 ， 保 持 名 称 有 关 。 名 称 太 重要 了 ， 
不 可 随意 对 待 。 

看 看 以 下 代码 。 这 段 代 码 是 做 什么 的 ? 用 了 好 名 称 的 代码 一 目 了 
然 ， 而 这 样 的 代码 却 是 符号 和 魔术 数 的 大 杂烩 。 

public int x() { 











int q = 0; 

int z = 0; 

for (int kk = 0; kk < 10; kk++) { 
if (I[z] == 10) 


{ 
q+= 10+ (I[z + 1] + I[z + 2]); 
z+=1; 
} 
else if (I[z] + l[z + 1] == 10) 
{ 
q += 10+ 1[z + 2]; 
ge 


} else 1 


q += I[z] + I[z + 1]; 
Z 二 = 2; 
return q; 


} 


} 

下 面 是 这 段 代码 应 该 写成 的 样子 。 代 码 片 段 实际 上 不 如 上 上 段 完 整 。 
但 你 还 是 能 蕊 上 推 师 出 它 要 做 什么 ， 而 且 很 有 可 能 依据 推 师 出 的 意思 写 
出 遗漏 的 函数 。 魔 术 数 不 复 神秘 ， 算 法 的 结构 也 足 具 描述 性 。 


public int score() { 





int score = 0; 
int frame = 0; 
for (int frameNumber = 0; frameNumber < 10; frameNumber++) { 
if (isStrike(frame)) { 
score += 10 + nextTwoBallsForStrike(frame); 
frame += 1; 
} else if (isSpare(frame)) { 
score += 10 + nextBallForSpare(frame); 
frame += 2; 
} else { 
score += twoBallsInFrame(frame); 


frame += 2; 


} 
return score; 
} 
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Prat He TE INT HH isStrike( ) 的 实现 。 读 到 isStrick 方 法 时 ， 它 “ 深 合 你 
意 ”[13]。 


private boolean isStrike(int frame) { 
return rolls[ frame] == 10; 
} 
N2: 名 称 应 与 抽象 层级 相符 
不 要 取 沟 通 实现 的 名 称 ， 取 反映 类 或 函数 抽象 层级 的 名 称 。 这 样 做 
不 容易 。 人 们 擅长 于 混杂 抽象 层级 。 每 次 浏览 代码 ， 你 总 会 发 现 有 些 变 
量 的 名 称 层级 太 低 。 你 应 当 趁机 为 之 改名 。 要 让 代码 可 读 ， 需 要 持续 不 
斯 的 改进 。 看 看 下 面 的 Modem 接 口 : 
public interface Modem { 
boolean dial(String phoneNumber); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 
String getConnectedPhoneNumber(); 
} 
粗 看 还 行 。 函 数 看 来 都 很 合适 ， 对 于 多 数 应 用 程序 来 说 是 这 样 。 不 
过 ， 想 想 看 某 个 应 用 中 有 些 调制 解 调 器 并 不 用 拨号 连接 的 情形 。 有 些 用 
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形 。 有 些 通过 向 USB 口 发 送 端 口 信息 连接 。 显 然 ， 有 关 电 话 写 人 码 的 信息 
束 是 位 于 错误 的 抽象 层级 了 。 对 于 这 种 情形 ， 更 好 的 命名 策略 可 能 是 : 


public interface Modem { 








boolean connect(String connectionLocator); 
boolean disconnect(); 


boolean send(char c); 


char recv(); 
String getConnectedLocator(); 

} 

现在 名 称 再 不 与 电话 号 人 码 有 关系 。 还 是 可 以 用 于 用 电话 写 人 码 的 情 
形 ， 也 可 以 用 于 其 他 连接 策略 。 

N3: 尽 可 能 使 用 标准 命名 法 

如 有 果 名 称 基 于 既 存 约定 或 用 法 ， 就 比较 易于 理解 。 例 如 ， 如 果 你 采 
用 油漆 工 模 式 ， 就 该 在 给 油漆 类 命名 时 用 上 Decorator 字样。 例如， 
AutoHangupModemDecorator 可 能 是 某 个 给 Modem 类 刷 上 在 会 话 结束 时 
自动 挂机 的 能 力 的 类 的 名 称 。 

模式 只 是 标准 的 一 种 。 例 如 ， 在 Java 中 ， 将 对 象 转换 为 字符 串 的 函 
数 通常 命名 为 toString。 最 好 是 遵循 这 些 约定 ， 而 不 是 自己 创造 命名 

对 于 特定 项 目 ， 开 发 团队 常 常 发 明 自 己 的 命名 标准 系统 。Eric 
Evans 称 之 为 项 目的 共同 语言 [14]。 代 码 应 该 使 用 来 自 这 种 语言 的 术 
语 。 简 言 之 ， 具 有 与 项 目 有 关 的 特定 意义 的 名 称 用 得 越 多 ， 读 者 就 越 容 
易 明日 你 的 代码 是 做 什么 的 。 

N4: 无 歧义 的 名 称 

选用 不 会 混 消 函数 或 变量 意义 的 名 称 。 看 看 来 自 FitNesse 的 这 个 例 
T: 

private String doRename() throws Exception 

{ 


if(refactorReferences) 

















renameReferences(); 
renamePage(); 
pathToRename.removeNameFromEnd(); 


pathToRename.addNameToEnd(newName); 


return PathParser.render(pathToRename); 

} 

该 函数 的 名 称 含混 不 清 ， 没 有 说 明 函 数 的 作用 。 由 于 在 doRename 
函数 里 面 还 有 个 名 为 renamePage 的 函数 ， 这 束 更 不 明白 了 ! 这 些 名 称 有 
没有 说 明 两 个 函数 之 间 的 区 别 呢 ? 没有 。 

该 函数 的 更 好 名 称 应 该 是 renamePageAndOptionallyAllReferences。 
看 似 太 长 ， 的 确 也 很 长 ， 不 过 它 只 在 模块 中 的 一 处 被 调 用 ， 所 以 其 解释 
性 的 好 处 大 过 了 长 度 的 坏处 。 

N5: 为 较 大 作用 范围 选用 较 长 名 称 

名 称 的 长 度 应 与 作用 范围 的 广泛 度 相 关 。 对 于 较 小 的 作用 范围 ， 可 
以 用 很 短 的 名 称 ， 而 对 于 较 大 作用 范围 就 该 用 较 长 的 名 称 。 

类 似 i 和 j 之 类 的 变量 名 对 于 作用 范围 在 5 行 之 内 的 情形 没 问 题 。 看 看 
以 下 来 自 老 “标准 保龄球 游戏 ”的 代码 片段 : 

private void rollMany(int n, int pins) 

{ 


for (int i=0; i<n; i++) 





g.roll(pins); 

j 

这 段 代 码 很 明白 ， 如 果 用 rollCount 之 类 烦人 的 名 称 代替 变量 i， 反 和 而 
是 徒 增 混乱 。 另 一 方面 ， 在 较 长 距离 上 ， 使 用 短 名 称 的 变量 和 函数 会 丧 
失 其 含义 。 名 称 的 作用 范围 越 大 ， 名 称 就 该 越 长 、 越 准确 。 

N6: 避免 编码 

不 应 在 名 称 中 包括 类 型 或 作用 范围 信息 。 在 如 今 的 开发 环境 中 ， 
m_ 或 { 之 类 前 绥 完 全 无 用 。 类 似 vis (表示 图 形 系统 ) 之 类 的 项 目 或 子 
系统 名 称 也 属 多 余 。 当 今 的 开 及 环境 不 用 纠缠 于 名 称 也 能 提供 这 些 信 
恩 。 不 要 用 匈牙利 语 命名 法 污染 你 的 名 称 。 

N7: 名 称 应 该 说 明 副 作用 











名 称 应 该 说 明 函 数 、 变 量 或 类 的 一 切 信 息 。 不 要 用 名 称 掩蔽 副 作 
用 。 不 要 用 简单 的 动词 来 描述 做 了 不 止 一 个 简单 动作 的 函数 。 例 如 ， 请 
看 以 下 来 自 TestNG 的 代码 : 
public ObjectOutputStream getOos() throws IOException { 
if (m_oos == null) { 
m_oos = new ObjectOutputStream(m_socket.getOutputStream()); 
} 
return m, oos; 
j 
该 函数 不 只 是 获取 一 个 oos， 如 果 oos 不 存在 ， 还 会 创建 一 个 。 所 
以 ， 更 好 的 名 称 大 概 是 createOrReturnOos。 


17.7 测试 


T1: 测试 不 足 

一 套 测 试 中 应 该 有 多 少 个 测试 ?不幸 的 是 ， 许 多 程序 员 的 衡量 标准 
是 “看 起 来 够 了 ”。 一 套 测 试 应 该 测 到 所 有 可 能 失败 的 东西 。 只 要 还 有 没 
被 测试 探测 过 的 条 件 ， 或 是 还 有 没 被 验证 过 的 计算 ， 测 试 就 还 不 够 。 

T2: (SE FA 4g ate 48 TA 

履 盖 率 工具 能 汇报 你 测试 策略 中 的 缺口 。 使 用 覆盖 率 工 具 能 更 容易 
地 找到 测试 不 足 的 模块 、 类 和 函数 。 多 数 IDE 都 给 出 直观 的 指示 ， 用 绿 
色 标 记 测 试 履 盖 了 的 代码 行 ， 而 未 宪 盖 的 代码 行 则 是 红色 。 这 样 就 能 
快 又 容易 地 找到 尚未 检测 过 的 i 或 catch 语 句 。 

T3: 别 略 过 小 测试 

小 测试 易于 编写 ， 其 文档 上 的 价值 高 于 编写 成 本 。 

T4: 被 忽略 的 测试 就 是 对 不 确定 事物 的 疑问 

有 时 ， 我 们 会 因为 需求 不 明 而 不 能 确定 某 个 行为 细节 。 可 以 用 注释 
掉 的 测试 或 者 用 @Ignore 标记 的 测试 来 表达 我 们 对 于 需求 的 疑问 。 使 用 
哪 种 方式 ， 取 决 于 该 不 确定 性 所 关 涉 代码 是 否 要 编译 。 

T5: 测试 边界 条 件 

特别 注意 测试 边界 条 件 。 算 法 的 中 间 部 分 正确 但 边界 判断 错误 的 情 
形 很 常见 。 

T6: 全 面 测试 相近 的 缺陷 

缺陷 趋 句 于 扎堆 。 在 茶 个 函数 中 友 现 一 个 缺陷 时 ， 最 好 全 面 测试 那 
个 函数 。 你 可 能 会 发 现 缺陷 不 止 一 个 。 

T7: 测试 失败 的 模式 有 启发 性 














有 时 ， 你 可 以 通过 找到 测试 用 例 失 败 的 模式 来 诊断 问题 所 在 。 这 也 
是 尽 可 能 编写 足够 完整 的 测试 用 例 的 理由 之 一 。 完 整 的 测试 用 例 ， 按 合 
理 的 顺序 排列 ， 能 暴露 出 模式 。 

简单 举例 ， 假 设 你 注意 到 所 有 长 于 5 个 字符 的 输入 都 会 导致 测试 失 
败 ， 或 者 向 函数 的 第 二 个 参数 传 入 负数 都 会 导致 测试 失败 。 有 时 ， 只 要 
看 看 测试 报告 的 红 绿 模式 ， 就 足以 绽放 出 那 句 带 来 解决 方法 的 “ 啊 
哈 ! ”回头 看 看 第 16 章 “ 重 构 SerialDate” 中 的 有 趣 例 子 吧 。 

T8: 测试 覆盖 率 的 模式 有 启发 性 

查看 被 或 未 被 已 通过 的 测试 执行 的 代码 ， 往 往 能 发 现 失败 的 测试 为 
何 失败 的 线索 。 

T9: 测试 应 该 快速 

慢 速 的 测试 是 不 会 被 运行 的 测试 。 时 间 一 紧 ， 较 慢 的 测试 就 会 被 摘 
fü. ATLA, aS PRE LEM Ae R 


17.8 小 结 





这 份 月 发 与 味道 的 清单 很 难说 已 完备 无 缺 。 我 不 能 确定 这 样 一 份 清 
单 会 不 会 完备 无 缺 。 但 或 许 完 整 性 不 该 是 目标 ， 因 为 该 清单 确实 给 出 了 
一 套 价值 体系 。 

那 套 价值 体系 才 该 是 目标 ， 也 是 本 书 的 主题 所 在 。 整 洁 代码 并 非 尊 
循 一 套 规则 写 就 。 学 习 一 系列 局 发 并 不 足以 让 你 成 为 软件 后 人 。 专 业 性 
和 技艺 来 自 于 驱动 规程 的 价值 观 。 
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IRA 并 发 编程 1 


Brett L.Schuchert 
本 附录 扩充 了 “并 发 编程 ”一 章 的 内 容 ， 由 一 组 相互 独立 的 主题 组 
成 ， 你 可 以 按 随意 顺序 阅读 。 为 了 实现 这 样 的 阅读 方式 ， 节 与 节 之 间 存 
在 一 些 重 复 内 容 。 
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想像 一 个 简单 的 客户 端 /服务 顺应 用 程序 。 服 务 器 在 一 个 套 接 字 上 
等 符 接 受 来 目 客 户 端的 连接 请 求 。 客 户 端 连 接 到 服务 器 并 发 送 请 求 。 


A.1.1 IRA 4s 








ite ibt A ds YF Ee RI RASS. FE CREP vit IRA as dE 
多 线程 版 本 ”一 市 中 有 完整 的 代码 。 
ServerSocket serverSocket = new ServerSocket(8009); 
while (keepProcessing) { 
try { 
Socket socket = serverSocket.accept(); 
process(socket); 
} catch (Exception e) { 
handle(e); 


} 
这 个 简单 的 应 用 等 待 连接 请 求 ， 处 理 接收 到 的 新 消息 ， 再 等 待 下 一 
个 客户 端 请 求 。 下 面 是 连接 到 服务 器 的 客户 端 代码 : 
private void connectSendReceive(int i) { 
try { 

Socket socket = new Socket("localhost", PORT); 
MessageUtils.sendMessage(socket, Integer.toString(i)); 
MessageUtils.getMessage(socket); 


socket.close(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
这 对 客户 端 /服务 器 程序 运行 得 如 何 呢 ? 怎样 才能 正式 地 描述 其 性 
能 ? 下 面 是 断言 其 性 能 “可 接受 ”的 测试 : 
@Test(timeout = 10000) 
public void shouldRunInUnder10Seconds() throws Exception { 
Thread[] threads = createThreads(); 
startAllThreadsw(threads); 
waitForAllThreadsToFinish(threads); 
j 
为 了 让 例子 够 简单 ， 设 置 过 程 被 忽略 了 《〈 见 后 文 ClientText.java 部 
分 ) 。 测 试 断言 程序 应 该 在 10000 毫 秒 内 完成 。 
这 是 个 验证 系统 否 吐 量 的 典型 例子 。 系 统 应 该 在 10 秒 钟 以 内 完成 一 
组 客户 端 请 求 。 只 要 服务 占 能 在 时 限 内 处 理 每 个 客户 端 请 求 ， 测 试 就 通 
BET 
如 果 测 试 失败 会 上 怎样? RD TREES], ESE EU, 
没什么 可 让 代码 更 快 的 手段 。 使 用 多 线程 能 解决 问题 吗 ? 可 能 会 ， 我 们 
先 得 了 解 什么 地 方 耗 费时 间 。 下 面 是 两 种 可 能 
I/ 等 待 虚 拟 内 存 交 换 等 ; 
处 理 需 一 一 数值 计算 、 正 则 表达 式 处 理 、 垃 圾 回收 等 。 
以 上 在 系统 中 都 会 部 分 存在 ， 但 对 于 特定 的 操作 ， 其 中 之 一 会 起 主 
导 作 用 。 如 果 代 码 运行 速度 主要 与 处 理 器 有 关 ， 增 加 处 理 器 硬件 就 能 提 
升 吞 吐 量 ， 从 而 通过 测试 。 但 CPU 运算 周期 是 有 上 限 的 ， 因 此 ， 只 是 增 
加 线程 的 话 并 不 会 提升 受 处 理 器 限制 的 代码 的 速度 。 
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他 事务 ， 从 而 更 有 效 地 利用 了 CPU 能 


A.1.2 添加 线程 代 古 





假定 性 能 测试 失败 了 。 如 何 才能 提高 吞吐 量 、 通 过 性 能 测试 昵 ? 如 
果 服 务 器 的 process 方 法 与 WO 有 关 ， 束 有 个 办 法 让 服务 器 利用 线程 (只 


需要 修改 processMessage) : 





void process(final Socket socket) { 
if (socket == null) 
return; 
Runnable clientHandler = new Runnable() { 
public void run() { 
try { 
String message = MessageUtils.getMessage(socket); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
closeIgnoringException(socket); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
}; 
Thread clientConnection = new Thread(clientHandler); 
clientConnection.start(); 
} 
假设 修改 后 测试 通过 了 [1]。 代 码 是 否 完整 、 正 确 了 呢 ? 


A.1.3 观 罕 服务 器 端 


修改 了 的 服务 器 成 功 通 过 测试 ， 只 花费 了 一 秒 多 钟 时 间 。 不 幸 的 
是 ， 这 种 解雇 手段 有 点 一 厢 情 愿 ， 而 且 导致 了 新 问题 产生 。 

服务 器 应 该 创建 多 少 个 线程 ? 代码 没有 设置 上 限 ， 所 以 我 们 很 有 可 
能 达到 Java ”虚拟 机 (JVM) 的 限制 。 对 于 许多 简单 系统 来 说 这 无 所 
谓 。 但 如 果 系 统 要 文 持 公众 网 络 上 的 众多 用 户 呢 ?如 果 有 太 多 用 户 同 时 
连接 ， 系 统 就 有 可 能 挂 掉 。 

不 过 先 把 性 能 问题 放 到 一 边 吧 。 这 种 手段 还 有 整洁 性 和 结构 上 的 问 
题 。 服 务 嚣 代码 有 多 少 种 权 员 呢 ? 

套 接 字 连接 管理 ; 

25 MLA; 

线程 策略 ; 

服务 器 关闭 策略 。 

这 些 权 责 不 竺 全 在 process 函 数 中 。 而 且 ， 代 码 跨 越 多 个 抽象 层级 。 
所 以 ， 即 便 process 函 数 这 么 短小 ， 还 是 需要 再 加 以 切 分 。 

服务 器 有 几 个 修改 的 原因 ， 上 所 以 它 违反 了 单一 权 责 原则 。 要 保持 并 
发 系统 整洁 ， 应 该 将 线程 管理 代码 约束 于 少数 几 处 控制 民 好 的 地 方 。 而 
且 ， 管 理 线程 的 代码 只 应 该 做 管理 线程 的 事 。 为 什么 ?即便 无 需 同 时 考 
碟 其 他 非 多 线程 代码 ， 跟 踪 并 发 问题 都 已 经 足够 困难 了 。 

如 果 为 上 述 每 个 权 责 〈 包 括 线程 管理 权 责 在 内 ) 创建 单独 的 类 ， 当 
改动 线程 管理 策略 时 ， 就 会 对 整个 代码 产生 较 小 影响 ， 不 至 于 污染 其 他 
权 责 。 这 样 一 来 ， 也 能 在 不 担心 线程 问题 的 前 提 下 测试 所 有 其 他 权 责 。 
下 面 是 修改 过 的 版 本 : 

public void run() { 























while (keepProcessing) { 
try { 


ClientConnection clientConnection = 
connectionManager.awaitClient(); 
ClientRequestProcessor requestProcessor 
= new ClientRequestProcessor(clientConnection); 
clientScheduler.schedule(requestProcessor); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
connectionManager.shutdown(); 
} 
所 有 与 线程 相关 的 东西 都 放 到 了 clientScheduler 里 面 。 如 果 出 现 并 
Ang, RGR SAT NR D: 
public interface ClientScheduler { 
void schedule(ClientRequestProcessor requestProcessor); 
j 
并 发 策略 易于 实现 : 
public class ThreadPerRequestScheduler implements ClientScheduler { 


public void schedule(final ClientRequestProcessor requestProcessor) 


Runnable runnable = new Runnable() { 
public void run() { 
requestProcessor.process(); 
} 
35 
Thread thread = new Thread(runnable); 
thread.start(); 


i 

{LATA ZE he BEBE SIMILE, (ECP ARENT CURA A E 
了 了。 例如， 移植 到 Java 5 ExecutorTE Rd Hr; ZIA — Pt RIF ER 
即 可 《如 代码 清单 A-1 所 示 ) > 

代码 清单 A-1 ExecutorClientScheduler.java 


import java.util.concurrent.Executor; 





import java.util.concurrent.Executors; 
public class ExecutorClientScheduler implements ClientScheduler { 
Executor executor; 
public ExecutorClientScheduler(int availableThreads) { 
executor = Executors.newFixedThreadPool(availableThreads); 


} 


public void schedule(final ClientRequestProcessor requestProcessor) 


Runnable runnable = new Runnable() { 
public void run() { 
requestProcessor.process(); 
} 
p 


executor.execute(runnable); 


A.1.4 小 结 
本 例 介 绍 的 并 发 编程 ， 演 示 了 一 种 提高 系统 吞吐 量 的 方法 ， 以 及 一 


种 通过 测试 框架 验证 吞吐 量 的 方法 。 将 全 部 并 发 代码 放 到 少数 类 中 ， 是 
应 用 单一 权 责 原则 的 范例 。 对 于 并 发 编程 ， 因 其 复杂 性 ， 这 一 点 尤其 重 


要 。 





A.2 执行 的 可 能 路 径 


复 碍 没有 循环 或 条 件 分 文 的 单行 Java 方 法 incrementValue: 
public class IdGenerator { 

int lastIdUsed; 

public int incrementValue() 1 


return ++lastIdUsed; 


} 

REA TRE, ABE RA EARTE BE 7 [J [dGenerator J i 
实体 。 这 种 情况 下 ， 只 有 一 种 执行 路 径 和 一 个 确定 的 结果 : 返回 值 等 于 
lastIdUsed 的 值 ， 两 者 都 比 调用 方法 前 大 1。 

如 果 使 用 两 个 线程 、 不 修改 方法 的 话 会 发 生 什 么 ? 如 果 每 个 线程 都 
调用 一 次 incrementValue， 可 能 得 到 什么 结果 呢 ? 有 多 少 种 可 能 执行 路 
径 ? 首先 来 看 结果 (假定 lastIdUsed 初 始 值 为 93〉: 

线程 1 得 到 94， 线 程 2 得 到 95，lastIdUsed 为 95; 

线程 1 得 到 95， 线 程 2 得 到 94，lastIdUsed 为 95; 

线程 1 得 到 94， 线 程 2 得 到 94，lastIdUsed 为 94。 

最 后 一 个 结果 尽管 令 人 吃惊， 也 是 有 可 能 出 现 的 。 要 想 明 日 为 何 可 
能 出 现 这 些 结果 ， 就 需要 理解 可 能 执行 路 径 的 数量 以 及 Java 虚 拟 机 是 如 
何 执行 这 些 路 径 的 。 





A.2.1 路 径 数量 


为 了 算出 可 能 执行 路 径 的 数量 ， 我 们 从 生成 的 字 节 码 开始 研究 。 那 


fT Java 代码 (return++lastIdUsed;) 变 成 了 8 个 字 节 码 指令 。 两 个 线程 有 
可 能 交错 执行 这 8 个 指令 ， 就 像 庄 家 在 洗 牌 时 交错 牌 张 一 样 2]。 即 便 每 
只 手 上 只 有 8 张 牌 ， 洗 牌 得 到 的 结果 数量 也 很 可 观 。 

对 于 指令 系列 中 有 N 个 指令 和 T 个 线程 、 没 有 循环 或 条 件 分 文 的 简 
单 情况 ， 总 的 可 能 执行 路 径 数 量 等 于 


(NT)! 
ONT 


计算 可 能 执行 次 序 

以 下 摘自 鲍 勃 大 叔 给 Brett 的 一 封 电 子 邮 件 : 

对 于 N 步 指令 和 T 个 线程 ， 总 共有 TxN 个 步骤 。 在 执行 每 步 指令 之 
前 ， 会 有 在 IT 个 线程 中 选择 其 一 的 环境 开关 。 因 而 每 条 路 径 都 能 以 一 个 
数字 字符 串 的 形式 来 表示 该 环境 开关 。 对 于 步骤 A、B 及 线程 1 和 2， 可 

6 条 可 能 路 径 : 1122、1212、1221、2112、2121 和 2211。 或 者 以 指 
令 步 又 表示 为 AIB1A2B2、A1A2B1B2、A1A2B2B1、A2A1B1B2、 
A2A1B2B1 及 A2B2A1B1。 对 于 三 个 线程 ， 执 行 序列 就 是 112233、 
112323, 113223, 113232, 112233, 121233, 121323, 121332, 

193 8208/23 [020098 

这 些 字符 串 的 特征 之 一 是 每 个 T 总 会 出 现 N 次 。 所 以 字符 串 111111 
是 无 效 的 ， 因 为 里 面 有 6 个 1， 而 2 和 3 则 未 出 现 过 。 

PD EHEAI2MAN1, N2...... MH ENT, AMEN = ANT 
排列 ， 即 (N*T)!， 但 要 剔除 重复 的 情形 。 所 以 ， 巧 妙 之 处 就 在 于 计算 重 
复 次 数 并 从 (N*T)! 中 剔除 掉 。 

对 于 两 步 指 令 和 两 个 线程 ， 有 多 少 重 复 呢 ? 每 个 四 位 数字 符 串 中 都 
有 两 个 1 和 两 个 2。 每 个 这 种 配对 都 可 以 在 不 影响 字符 串 意义 的 前 提 下 调 














换 。 可 以 同时 调换 全 部 1 和 2， 也 可 以 都 不 调换 。 所 以 每 个 字符 串 就 有 
四 种 同 构 形 态 ， 即 存在 3 次 重复 。 所 以 四 分 之 三 的 路 径 是 重复 的 ， 而 四 
分 之 一 的 排列 则 不 重复 。4!*.25=6。 这 样 计 算 看 来 可 行 。 

有 多 少 重 复 呢 ? 对 于 N=1 且 T=2 的 情形 ， 我 可 以 调换 1， 调 换 2， 或 
两 者 都 调换 。 对 于 N=2 且 T=3 的 情形 ， 我 可 以 调换 1、2、3，1 和 2，1 和 
3， 或 2 和 3。 调 换 只 是 N 的 排列 组 合 罢 了 。 设 有 N 的 P 种 排列 组 合 。 排 列 
组 合 的 方式 总 共有 P**T 种 。 

所 以 可 能 的 同 构 形 态 数 量 为 Ni**T。 路 径 的 数量 就 是 
(T*N)V(INI**T)。 对 于 T=2 且 N=2 的 情况 ， 结 果 就 是 6〈 即 24/4) . 

对 于 N=2 且 T=3， 结 果 是 720/8=90。 

对 于 N=3 且 T=3， 结 果 是 91/6^3=1680。 

对 于 一 行 Java 代 码 〈 等 同 于 8 行 字 节 码 ) 和 两 个 线程 的 简单 情况 ， 
可 能 执行 路 径 的 总 数量 就 是 12870。 如 果 lastIdUsed 的 类 型 为 Iong， 每 次 
读 / 写 操作 都 变 成 了 两 次 操作 ， 而 可 能 的 次 序 高 达 2704156 种 。 

如 果 改 动 一 下 该 方法 会 怎样 ? 

public synchronized void incrementValue() { 

++lastIdUsed; 

} 

这 样 一 来 ， 对 于 两 个 线程 的 情况 ， 可 能 执行 路 径 的 数量 就 是 2， 即 
N! 

















两 个 线程 都 调用 方法 一 次 《在 添加 synchronize 之 前 ) 、 得 到 同一 结 
果 数 字 的 尺 异 结果 又 怎样 呢 ? 怎么 可 能 出 现 这 种 情况 ”一样 一 样 来 。 

什么 是 原子 操作 ? 可 以 把 原子 操作 定义 为 不 可 中 断 的 操作 。 例 如 ， 
在 下 列 代 码 的 第 5 行 ，0 被 赋值 给 lastid， 就 是 一 个 原子 操作 。 因 为 依据 


Java 内 存 模 型 ，32 位 值 的 赋值 操作 是 不 可 中 断 的 。 
01: public class Example { 
02: int lastId; 


04: public void resetId() { 
05: value - 0; 
06: j 


08: public int getNextId() 1 

09: ++value; 

10: } 

11: } 

如 果 把 lastId 的 类 型 从 int 改 为 long 会 怎样 ? 第 5 行 还 是 原子 操作 吗 ? 
如 果 不 考 虑 JVM 规 约 ， 则 有 可 能 根据 处 理 器 不同 而 不 同 。 不 过 ， 根 据 
JVM 规 约 ，64 位 值 的 赋值 需要 两 次 32 位 赋值 。 这 意味 着 在 第 一 次 和 第 二 
次 32 位 赋值 之 间 ， 其 他 线程 可 能 插 进 来 ， 修 改 其 中 一 个 值 。 

第 9 行 的 前 递增 操作 符 ++ 又 怎样 呢 ? 前 递增 操作 符 可 以 被 中 断 ， 所 
以 它 不 是 原子 的 。 为 了 理解 这 点 ， 人 和 仔细 复查 一 下 这 些 方法 的 字 市 码 吧 。 

在 更 进一步 之 前 ， 有 三 个 重要 的 定义 : 

框架 一 一 每 个 方法 调用 都 需要 一 个 框架 。 该 框 染 包 括 返 回 地 址 、 传 
入 方法 的 参数 ， 以 及 方法 中 定义 的 本 地 变量 。 这 是 定义 一 个 调用 堆栈 的 
标准 技术 ， 现 代 编 程 语言 用 来 实现 基本 函数 /方法 调用 和 递归 调用 

本 地 变量 一 一 方法 作用 范围 内 定义 的 每 个 变量 。 所 有 非 静 态 方 法 至 
少 有 一 个 变量 this， 代 表 当 前 对 象 ， 即 接收 导致 方法 调用 的 (当前 线程 
A) 大 多 数 最 新 消息 的 对 象 ; 

运算 对 象 栈 一 一 Java 虚 拟 机 中 的 许多 指令 都 有 参数 。 运 算 对 象 栈 是 
放置 参数 的 地 方 。 堆 栈 是 个 标准 的 后 入 先 出 《LIFO) 数据 结构 。 


























下 面 是 restId() 的 字 节 码 ， 如 表 A-1 所 示 。 


KA-1 restId( ) 的 字 节 码 





HT 描述 操作 对 象 栈 
ALOAD 0 将 第 0 个 变量 放 到 操作 对 象 栈 中 。 什 么 是 第 0 12 | this 


量 ? 就 是 this， 当 前 对 象 。 当 方法 被 调用 ， 消 息 接 
收 者 ，Example 的 一 个 实体 ， 被 推 到 为 方法 调用 创 
建 的 框架 的 本 地 变量 数组 中 。 这 总 是 放 进 每 个 实体 
方法 的 第 一 个 变量 

ICONST 0 将 常量 值 0 放 到 操作 对 象 栈 中 this, 0 


PUTFIELD lastlId “| 将 堆栈 中 的 第 一 个 值 ( 即 0) 存储 到 引用 对 象 的 字 | «empty» 
段 值 ， 距 堆栈 项 部 this 一 个 对 象 引用 的 距离 


这 三 个 指令 确保 是 原子 的 ， 因 为 尽管 执行 它们 的 线程 可 能 在 其 中 任 
何 一 个 指令 后 被 打 断 ， 但 PUTFIELD 指 令 〈 推 栈 顶 部 的 常量 值 0 和 顶端 
之 下 的 this 引 用 及 其 字段 值 ) 的 信息 并 不 能 为 其 他 线程 所 触及 。 所 以 ， 
当 赋 值 操 作 发 生 时 ， 值 0 一 定 将 存储 到 字段 值 中 。 该 操作 是 原子 的 。 操 
作对 象 都 处 理 对 于 方法 而 言 是 本 地 的 信息 ， 故 在 多 个 线程 之 间 并 无 冲 
突 。 

所 以 ， 如 果 这 三 个 指令 由 10 个 线程 执行 ， 就 会 有 
4.38679733629e+24 种 可 能 的 执行 次 序 。 不 过 ， 只 会 有 一 种 可 能 的 结 
果 ， 所 以 执行 次 序 不 同 无 关 紧要 。 对 于 本 例 中 的 long 常 量 ， 总 是 有 同一 
种 运算 结果 。 为 什么 ? 因为 10 个 线程 的 赋值 操作 都 是 针对 一 个 常量 的 。 
即便 它们 互相 干涉 ， 结 果 也 是 一 样 。 

方法 getNextId 中 的 ++ 操 作 就 会 有 问题 了 。 假 定 lastId 在 方法 开始 时 
的 值 为 42. 下 面 是 新 方法 的 字 节 码 ， 如 表 A-2 所 示 。 
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KA-2 新 方法 的 字 节 码 


HT 描述 操作 对 象 栈 








ALOAD 0 将 this 装载 到 操作 对 象 栈 this 
DUP 复制 堆栈 顶部 内 容 。 在 对 象 栈 中 有 两 个 this 的 复 本 this, this 





GETFIELD 从 指向 堆栈 顶部 Chis). 的 对 象 中 取得 字段 lastId 的 值 ，| this, 42 
lastId 并 存储 回 堆 栈 中 























ICONST 1 将 整数 常量 1 推 入 堆栈 fis 42,1 
IADD 对 堆栈 顶部 的 两 个 值 做 整数 加 操作 ， 将 结果 存储 回 堆栈 this, 43 
DUP XI 复制 值 43， 放 到 this 之 前 43, this, 43 
PUTFIELD 将 堆栈 顶部 的 值 43 放 到 当前 对 象 的 字段 值 中 ， 表 现 为 |43 

value 对 象 栈 中 的 下 一 个 值 this 

IRETURN BERT Cm AA ze TRS) 的 值 <empty> 





设想 第 一 个 线程 完成 了 前 三 个 操作 ， 直 到 执行 完 GETFIELD， 然 后 
被 打 断 。 第 二 个 线程 接手 并 完成 整个 方法 调用 ，lastId 的 值 递 增 1; 得 到 
的 值 为 43。 第 一 个 线程 再 从 中 断 处 继续 执行 ， 操 作对 象 栈 中 的 值 还 是 
42， 因 为 那 就 是 该 线程 执行 GETFIELD 时 的 lastId 值 。 线 程 给 lastId 加 1， 
得 到 43， 存 储 这 个 结果 。 第 一 个 线程 也 得 到 了 值 43。 结 果 就 是 其 中 一 个 
递增 操作 丢失 了 ， 因 为 第 一 个 线程 在 被 第 二 个 线程 打 断 后 又 踏 入 了 第 二 
个 线程 中 。 

将 getNextId( ) 方 法 修改 为 同步 方法 就 能 修正 这 个 问题 。 


A.2.3 小 结 


理解 线程 之 间 如 何 互 相干 涉 ， 并 不 一 定 要 精通 字 节 码 。 如 果 你 能 看 
明日 这 个 例子 ， 它 应 该 已 经 展示 了 多 个 线程 之 间 互 相干 涉 的 可 能 性 ， 这 
DAER J.o 

这 个 小 例子 说 明 ， 有 必要 尽量 理解 内 存 模型 ， 明 白 什么 是 安全 的 ， 
什么 是 不 安全 的 。 有 一 种 普遍 的 误解 ， 认 为 ++ 前 递增 或 后 递增 ) 操作 
符 是 原子 的 ， 其 实 并 非 如 此 。 你 必须 知道 : 

AMT AK ET RAE; 

哪些 代码 会 导致 并 发 读 / 写 问题 ; 











如 何 防止 这 种 并 发 问题 发 生 。 


A.3 了 解 类 


A.3.1 Executor# JE 


如 前 文 ExecutorClientScheduler.java 所 演示 的 那样 ，Java 5 中 引入 的 
Executor 框 架 文 持 利用 线程 池 进 行 复杂 的 执行 。 那 驶 是 
java.util.concurrent 包 中 的 一 个 类 。 

如 果 在 创建 线程 时 没有 使 用 线程 池 或 自行 编写 线程 池 ， 可 以 考虑 使 
用 Executor。 它 能 让 代码 更 整洁 ， 易 于 理解 ， 且 更 加 短小 。 

Executor 框架 将 把 线程 放 到 池 中 ， 自 动 调整 其 大 小 ， 并 在 必要 时 重 
建 线程 。 它 还 文 持 future， 一 种 通用 的 并 发 编程 构造 。Executor ”能 与 实 
现 了 ”Runnable 的 类 协同 工作 ， 也 能 与 实现 了 Callable 接 口 的 类 协同 工 
作 。Callback 看 来 就 像 是 Runnable， 但 它 能 返回 一 个 结果 ， 那 在 多 线程 
解决 方案 中 是 普 授 的 需求 。 

当代 码 需 要 执行 多 个 相互 独立 的 操作 并 等 待 这 些 操 作 结 束 时 ， 
future Ef SLT : 

public String processRequest(String message) throws Exception 1 


Callable<String> makeExternalCall = new Callable<String>() 1 








public String call() throws Exception 1 
String result = ""; 
// make external request 
return result; 
j 
n 


Future<String> result = executorService.submit(makeExternalCall); 


String partialResult = doSomeLocalProcessing(); 
return result.get() + partialResult; 
} 
在 本 例 中 ， 方 法 开始 执行 makeExternalCall 对 象 。 然 后 该 方法 继续 
其 他 操作 。 最 后 一 行 代码 调用 result.get( )， 在 future 代 码 执行 完成 前 ， 这 
个 操作 是 锁定 的 。 


A.3.2 非 锁定 的 解决 方案 


Javab ”虚拟 机 利用 了 现代 处 理 器 支持 可 靠 、 非 锁定 更 新 的 设计 优 
点 。 例 如 ， 考 虑 某 个 使 用 同步 (从 而 也 是 锁定 的 〉 来 提供 线程 安全 地 更 
新 一 个 值 的 类 : 

public class ObjectWithValue { 

private int value; 
public void synchronized incrementValue() { ++value; } 
public int getValue() { return value; } 

} 

Java5 有 一 系列 用 于 此 类 情况 的 新 类 ， 例 如 AtomicBoolean、 
AtomicImteger 和 AtomicReference 等 ， 还 有 另外 一 些 。 我 们 可 以 重 写 上 面 
的 代码 ， 使 用 非 锁定 的 手段 ， 如 下 所 示 : 

public class ObjectWithValue { 

private AtomicInteger value = new AtomicInteger(0); 

public void incrementValue() { 
value.incrementAndGet(); 

} 

public int getValue() { 


return value.get(); 


} 

即便 使 用 了 对 和 象 而 非 直接 操作 ， 使 用 了 incrementAndGet(. ) 这 样 的 
言 恩 发 送 方式 而 非 ++ 操 作 ， 这 个 类 的 性 能 还 是 几乎 总 能 胜 过 上 一 版 本 。 
在 某 些 情况 下 只 会 快 一 点 点 ， 但 较 慢 的 情形 却 几 乎 不 存在 。 

怎么 会 这 样 ? 现代 处 理 器 拥有 一 种 通常 称 为 比较 交换 (Compare 
and Swap, CASO 的 操作 。 这 种 操作 类 似 于 数据 库 中 的 乐观 锁定 ， 而 其 
同步 版 本 则 类 似 于 保守 锁定 。 

关键 字 synchronized 总 是 要 求 上 锁 ， 即 便 第 二 个 线程 并 不 更 新 同一 
值 时 也 如 此 。 尽 管 这 种 固有 和 锁 的 性 能 一 直 在 提升 ， 但 仍然 代价 昂贵 。 

非 上 锁 的 版 本 假定 多 个 线程 通常 并 不 频繁 修改 同一 个 值 ， 守 致 问 题 
产生 。 它 高 效 地 侦 测 这 种 情形 是 否 发 生 ， 并 不 断 答 试 ， 直 至 更 新 成 功 。 
这 种 侦 测 行为 几乎 总 是 比 上 锁 来 得 划算 ， 在 争 用 激烈 的 情况 下 也 是 如 
Jt. 

虚拟 机 如 何 实现 这 种 机 制 ? CAS 的 操作 是 原子 的 。 逻 辑 上 ，CAS 操 
作 看 起 来 像 这 样 : 


int variableBeingSet; 














void simulateNonBlockingSet(int newValue) { 
int currentValue; 
do { 
currentValue = variableBeingSet 
} while(currentValue l= compareAndSwap(currentValue, 
newValue)); 
} 
int synchronized compareAndSwap(int currentValue, int newValue) { 
if(variableBeingSet == currentValue) { 


variableBeingSet = newValue; 


return currentValue; 
} 
return variableBeingSet; 
} 
当 某 个 方法 试图 更 新 一 个 共享 变量 ，CAS 操 作 就 会 验证 要 赋值 的 变 
量 是 否 保 有 上 一 次 的 已 知 值 。 如 果 是 ， 就 修改 变量 值 。 如 果 不 是 ， 则 不 
会 伴 变 量 ， 因 为 另 一 个 线程 正在 试图 更 新 变量 值 。 要 更 新 数据 的 方法 
(通过 CAS 操 作 〉 查 看 是 否 修 改 并 持续 尝试 。 








A.3.3 非 线程 安全 类 


有 些 类 天 生 不 是 线程 安全 的 。 下 面 是 几 个 例子 : 

数据 库 连 接 

java.util F AY A as 

Servlet 

注意 ， 有 些 群 集 类 拥有 一 些 线程 安全 的 方法 。 不 过 ， 涉 及 调用 多 个 
方法 的 操作 都 不 是 线程 安全 的 。 例 如 ， 如 果 因 为 HashTable 中 已 经 有 某 
物 而 不 打算 蔡 换 它 ， 可 能 会 写 出 以 下 代码 : 

if(!hashTable.containsKey(someKey)) { 





hashTable.put(someKey, new SomeValue()); 
} 
单个 方法 是 线程 安全 的 。 不 过 ， 另 一 个 线程 却 可 能 在 containsKey 和 
put 调 用 之 间 窄 进 一 个 值 。 有 几 种 修正 这 个 问题 的 手段 。 
先 锁定 HashTable， 确 定 其 他 使 用 者 都 做 了 基于 客户 端的 锁定 : 
synchronized(map) { 
if(!map.conainsKey(key)) 
map.put(key,value); 


} 
用 其 对 象 包 装 HashTable， 并 使 用 不 同 的 API 一 一 利用 ADAPTER 模 
式 做 基于 服务 端的 锁定 : 

public class WrappedHashtable<K, V> { 

private Map<K, V> map = new Hashtable<K, V>(); 

public synchronized void putIfAbsent(K key, V value) { 

if (map.containsKey(key)) 
map.put(key, value); 


} 
采用 线程 安全 的 群集 : 


ConcurrentHash Map<Integer, String> map 


new 
ConcurrentHashMap<Integer, String>(); 

map.putIfAbsent(key, value); 

在 java.util.concurrent 中 的 群集 都 有 putIfAbsent( ) 之 类 提供 这 种 操作 
HA HE. 





以 下 是 一 个 有 关 在 方法 间 引 入 依赖 的 小 例子 : 
public class IntegerIterator implements Iterator<Integer> 
private Integer nextValue = 0; 
public synchronized boolean hasNext() { 
return nextValue < 100000; 
} 
public synchronized Integer next() { 
if (nextValue == 100000) 
throw new IteratorPastEndException(); 
return nextValue++; 
} 
public synchronized Integer getNextValue() { 


return nextValue; 


} 
下 面 是 使 用 Integerlterator 的 代码 : 
IntegerIterator iterator = new Integerlterator(); 
while(iterator.hasNext()) { 

int nextValue = iterator.next(); 


// do something with nextValue 


} 


如 果 只 有 一 个 线程 执行 这 段 代 码 ， 不 会 有 什么 问题 。 但 如 果 有 两 个 








线程 抱 着 每 个 线程 都 处 理 它 获得 的 值 、 但 列表 中 的 每 个 元 素 都 只 被 处 理 
一 次 的 意图 ， 和 艾 试 共享 Integerlterator 的 单个 实体 ， 会 发 生 什 么 事 ? E 
时 候 什 么 也 不 会 发 生 ;， 线程 开心 地 共享 着 列表 ， 处 理 从 友 代 器 获取 的 元 
素 ， 在 迭代 器 完成 执行 时 停 下 。 然 而 ， 在 迭代 的 末尾 ， 两 个 线程 也 有 少 
量 可 能 互相 干涉 ， 导 致 其 中 一 个 超出 迭代 器 末尾 ， 抛 出 异常 。 

问题 在 这 里 。 线 程 1 调 用 hasNext( ) 方 法 ， 该 方法 返回 true。 线 程 1 占 
先 ， 然 后 线程 2 也 调用 这 个 方法 ， 同 样 返回 true。 线 程 2 接着 调用 next( )， 
该 方法 如 期 返回 一 个 值 ， 但 副作用 是 之 后 再 调用 hasNext( ) 就 会 返回 
false。 线 程 1 继 续 执 行 ， 以 为 hasNext( ) 还 是 true， 然 后 调用 next( )。 即 便 
单个 方法 是 同步 的 ， 客 户 端 还 是 使 用 了 两 个 方法 。 

这 的 确 是 个 问题 ， 也 是 并 发 代码 中 此 类 问题 的 典型 例子 。 在 这 个 特 
殊 例 子 中 ， 问 题记 其 隐蔽 ， 因 为 只 有 在 迭代 器 最 后 一 次 迭代 时 发 生 才 会 
导致 错误 。 如 果 线 程 刚 好 在 那个 点 中 断 ， 其 中 一 个 线程 就 可 能 超出 迭代 
器 末 尾 。 这 类 错误 往往 在 系统 部 蜀 之 后 很 久 才 发 生 ， 而 且 很 难 奶 踪 。 

出 现 错 误 时 ， 你 有 3 种 做 法 。 

容忍 错误 ; 

修改 客户 代码 解决 问题 ， 基 于 客户 代码 的 锁定 ; 

修改 服务 端 代码 解决 问题 ， 同 时 也 修改 了 客户 代码 : 基于 服务 端的 
锁定 。 
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有 时 ， 可 以 通过 一 些 设 置 让 错误 不 会 导致 损害 。 例 如 ， 上 述 客户 代 
码 可 以 捕捉 并 清理 录 常 。 坦 白地 说 ， 这 有 点 草草 从 事 ， 就 像 是 半夜 重 局 
解决 内 存 泄露 问题 一 样 。 








A.4.2 基 3 代码 的 锁定 





要 让 Integerlterator 在 多 线程 情况 下 正确 运行 ， 对 客户 代码 做 如 下 修 
改 : 

IntegerIterator iterator = new Integerlterator(); 

while (true) { 

int nextValue; 
synchronized (iterator) { 
if (!iterator.hasNext()) 
break; 
nextValue = iterator.next(); 
} 
doSometingWith(nextValue); 

} 

每 个 客户 端 都 通过 synchronized 关 键 字 引入 一 个 锁 。 这 种 重复 违反 
了 DRY 原 则 ， 但 如 果 代 码 使 用 非 线程 安全 的 第 三 方 工具 ， 可 能 必须 这 样 
做 。 

这 种 策略 有 风险 ， 因 为 使 用 服务 端的 程序 员 都 得 记 住 在 使 用 前 上 
锁 、 用 过 后 解锁 。 许 多 “〈 许 多 ! ) 年 前 ， 我 遇 到 过 一 个 在 共享 资源 上 应 
用 基于 客户 代码 锁定 的 系统 。 人 代码 中 有 几 百 处 用 到 这 个 资源 的 地 方 。 有 
位 可 怜 的 程序 员 忘 记 在 其 中 一 处 做 资源 锁定 。 

该 系统 是 个 多 终端 分 时 系统 ， 为 Local 705 卡车 司机 联盟 运行 会 计 
软件 。 计 算 机 放 在 距 Local 705 总 部 50 英 里 《〈 约 84.65km ) 以 北 的 一 间 镶 
有 高 于 地 面 的 地 板 、 环 境 可 控 的 机 房 中 。 总 部 有 几 十 位 数据 录入 员 ， 往 
终端 输入 记录 。 终 端 使 用 电话 专线 和 600bits 的 半 双 工 调 制 解 调 器 连接 
到 计算 机 。《 这 可 是 很 久 很 久 以 前 的 事 了 。) 

每 天 大 概 都 会 有 一 侣 终端 室 无 理由 地 “和 死 锁 ”。 和 死 锁 也 不 限定 在 某 些 
终 闻 或 特定 时 间 。 就 像 是 有 人 撕 般 子 选择 死 锁 的 时 机 和 终端 一 般 。 有 
时 ， 会 有 几 台 终端 死 锁 。 有 时 ， 好 几 天 都 不 出 现 死 锁 情 况 。 














刚 开 始 ， 唯 一 的 解决 手段 就 是 重启 。 但 协同 起 来 很 不 便 。 我 们 得 打 
电话 给 总 部 ， 让 大 家 都 完成 在 终端 上 的 工作 。 然 后 我 们 才能 关机 、 重 
启 。 如 果 有 人 在 做 要 花 上 一 两 个 小 时 才能 做 完 的 事 ， 被 锁定 的 终端 就 只 
能 一 直 等 着 。 

经 过 几 个 星期 的 调试 ， 我 们 发 现 ， 原 因 在 于 一 个 指针 不 同步 的 环形 
缓冲 区 计数 费 。 该 缓冲 区 控制 同 终端 的 输出 。 指 针 值 说 明 缓冲 区 是 空 
的 ， 但 计数 器 却 指 出 缓冲 区 是 满 的 。 因 为 缓冲 区 是 空 的， 就 没什么 可 显 
zh; 但 因为 缓冲 区 也 是 满 的 ， 也 束 无 法 回 其 中 加 入 可 在 屏幕 上 显示 的 内 











我 们 知道 了 终端 为 何 会 死 锁 ， 但 却 不 知道 为 什么 环形 缓冲 区 会 不 同 
步 。 我 们 用 了 点 手段 发 现 问 题 所 在 。 当 时 程序 能 够 读 取 计 算 机 的 前 面板 
开关 状态 〈 这 可 是 很 久 很 久 以 前 的 事 了 ) 。 我 们 写 了 个 陷阱 程序 ， 侦 测 
这 些 开关 何 时 被 拨 动 ， 然 后 查找 既 空 又 满 的 环形 缓冲 区 。 如 果 找 到 ， 就 
重 置 该 缓冲 区 为 空 。 乌 拉 ! 锁定 的 终端 又 重新 开始 显示 了 。 

PE, FERRY HB SE ETRE ROT 客户 只 需要 打 电 话 告诉 我 
们 出 现 死 锁 ， 我 们 就 径直 走 到 机 房 ， 拨 动 一 下 开关 即 可 。 

当然 ， 有 时 他 们 会 在 周末 加 班 ， 但 是 我 们 可 不 加 班 。 所 以 我 们 又 在 
计划 列表 中 添加 了 一 个 函数 ， 每 分 钟 检查 一 次 全 部 环形 缓冲 区 ， 重 置 既 
空 又 满 的 缓冲 区 。 在 客户 打 电 话 之 前 ， 显 示 就 已 经 恢复 正常 了 。 

在 发 现 问题 原因 之 前 ， 我 们 花 了 好 几 个 星期 查看 一 页 又 一 页 的 单 片 
机 汇编 语言 代码 。 我 们 已 经 完成 计算 ， 算出 死 锁 的 频率 是 周期 性 的 ， 而 
且 其 中 有 一 处 未 受 保护 的 环形 缓冲 区 使 用 。 所 以 ， 剩 下 的 任务 就 是 找 出 
那个 错误 的 用 法 。 不 幸 这 是 多 年 以 前 的 事 ， 那 时 既 没 有 搜索 工具 ， 也 没 
有 交叉 引用 或 任何 其 他 自动 化 帮助 手段 。 我 们 只 能 细 查 代码 清单 。 

在 芝加哥 1971 年 的 寒冬 ， 我 学 到 了 重要 的 一 课 。 基 于 客户 代码 的 锁 
定 实在 不 可 靠 。 














A.4.3 基于 服务 端的 锁定 


按照 以 下 方式 修改 IntegerIterator 也 能 消除 重复 : 
public class IntegerIteratorServerLocked { 
private Integer nextValue = 0; 
public synchronized Integer getNextOrNull() { 
if (nextValue < 100000) 
return nextValue++; 
else 


return null; 


} 

客户 代码 也 要 修改 : 

while (true) { 

Integer nextValue = iterator.getNextOrNull(); 
if (next == null) 

break; 
// do something with nextValue 

} 

在 这 种 情形 下 ， 我 们 实际 上 是 修改 了 类 的 API， 使 其 能 适应 多 线 
程 B]。 客 己 问 需要 做 null 检 查 ， 而 不 是 检查 hasNext( )。 

通常 你 应 该 选用 基于 服务 端的 锁定 ， 因 为 : 

它 减 少 了 重复 代码 一 一 采用 基于 客户 代码 的 锁定 ， 每 个 客户 端 都 要 
正确 锁定 服务 端 。 把 锁定 代码 放 到 服务 端 ， 客 户 端 就 能 自由 使 用 对 象 ， 
不 必 费 心 编写 额外 的 锁定 代码 ; 

它 提 升 了 性 能 一 一 在 单线 程 部 著 中 ， 可 以 用 非 多 线程 安全 服务 端 代 
码 符 代 线 程 安全 客户 端 ， 从 而 省 去 人 花 销 ; 








TIR T d BUR SÉTE— — HR AH EE ie Et; 

ERIT T ER HRS VAR ERI IE SSH, T ANE 
在 许多 地 方 ( 每 个 客户 端 ) 实施 ; 

它 缩减 了 共 至 变量 的 作用 范围 一 一 客户 端 不 必 关 心 它们 或 它们 是 如 
何 锁定 的 。 一 切 都 隐藏 在 服务 器 。 如 果 出 错 ， 要 侦 碍 的 范围 就 小 多 了 。 

如 果 你 无 法 修改 服务 端 代码 又 该 如 何 ” 

使 用 ADAPTER 模 式 修 改 API， 添 加 锁定 ; 

public class ThreadSafeIntegerIterator { 





private IntegerIterator iterator = new Integerlterator(); 
public synchronized Integer getNextOrNull() { 
if(iterator.hasNext()) 
return iterator.next(); 


return null; 


} 
更 好 的 方法 是 使 用 线程 安全 的 群集 和 扩展 接口 。 


A.5 提升 吞吐 量 


假设 我 们 打算 连接 上 网 ， 从 一 个 URL 列 表 中 读 取 一 组 页 面 的 内 容 。 
读 到 一 个 页 面 时 ， 解 析 该 页 面 并 得 到 一 些 统 计 结 果 。 读 完 所 有 页 面 后 ， 
打印 出 一 份 提要 报表 。 
下 面 的 类 返回 给 定 URL 的 页 面 内 容 : 
public class PageReader { 
as 
public String getPageFor(String url) 1 
HttpMethod method = new GetMethod(url); 
try 1 
httpClient.executeMethod(method); 
String response = method.getResponseBodyAsString(); 
return response; 
} catch (Exception e) { 
handle(e); 
} finally { 


method.releaseConnection(); 


} 
FAREA URLA aE PET AA AS as 
public class Pagelterator { 


private PageReader reader; 


private URL Iterator urls; 
public Pagelterator(PageReader reader, URLIterator urls) { 
this.urls = urls; 
this.reader = reader; 
} 
public synchronized String getNextPageOrNull() { 
if (urls.hasNext()) 
getPageFor(urls.next()); 
else 
return null; 
} 
public String getPageFor(String url) { 


return reader.getPageFor(url); 


} 

Pagelterator 的 一 个 实体 可 为 多 个 不 同 线程 共享 ， 每 个 线程 使 用 自己 
的 PageReader 实 体 读 取 并 解析 从 迭代 器 中 得 到 的 页 面 。 

注意 ， 我 们 把 synchronized 代 码 块 的 数量 限制 在 小 范围 之 内 。 它 只 
包括 深 处 于 Pagelterator 内 部 的 临界 区 。 最 好 是 尽 可 能 少 地 使 用 同步 。 








A.5.1 单线 程 条 Arta 


来 做 个 简单 计算 。 鉴 于 讨论 的 目的 ， 假 定 : 

获取 一 个 页 面 的 VO 时 间 (平均 ) 是 1s; 

解析 一 个 页 面 的 处 理 时 间 PH) 是 0.5s; 

IO 操作 不 耗 融 处 理 器 能 力 ， 而 解析 页 面 耗费 100% 处 理 堪 能力。 

对 于 单个 线程 要 处 理 的 N 个 页 面 ， 总 的 执行 时 间 为 1.5s*N。 图 A-1 显 


示 了 13 个 页 面 或 大 概 19.5s 的 快照 。 
单线 程 


获得 页 面 LETITIA I a 
图 A-1 单线 程 


A.5.2 多 线程 条 JAHE 





如 果 能 够 以 任意 次 序 获得 页 面 并 独立 处 理 页 面 ， 就 有 可 能 利用 多 线 
程 提升 吞吐 量 。 如 采 我 们 使 用 三 个 线程 会 如 何 ? 在 同一 时 间 内 能 获取 多 
少 个 页 面 呢 ? 

如 你 在 图 A-2 中 所 见 ， 多 线程 方案 中 与 处 理 喜 能 力 有 关 的 页 面 解析 
操作 可 以 和 与 MO 有 关 的 页 面 读 取 操作 登 加 进行 。 在 理想 状态 下 ， 这 意 
味 着 处 理 器 力 尽 其 用 。 每 个 耗 时 一 秒 钟 的 页 面 读 取 操 作 都 与 两 次 解析 操 
作 登 加 进行 。 这 样 ， 我 们 残 能 在 每 秒 钟 内 处 理 两 个 页 面 ， 即 三 倍 于 单线 
程 方案 的 吞吐 量 。 











线程 1 


获得 页 面 LINIIIVTI/IVI/IIIVIIII|/I/I}III{{I{/K{I{IKIKI\{KI 


线程 2 


获得 页 面 LIIIIIIIIIIII{{KIK{ILII {ILL} \LILLILLIAILILLII 
线程 3 


获得 页 面 LIIIIIIIIIIIII//II/I//IIIIIIIIIIIIIIIII{1| 
图 A-2 三 个 并 发 线程 








A.6 SEF 


想象 一 个 拥有 两 个 有 限 共享 资源 池 的 Web 应 用 程序 。 

一 个 用 于 本 地 临时 工作 存储 的 数据 库 连 接 池 ; 

一 个 用 于 连接 到 主 存储 库 的 MQ 池 。 

假定 该 应 用 中 有 两 个 操作 : 创建 和 更 新 。 

创建 一 一 获取 到 主 存 储 库 和 数据 库 的 连接 。 与 主 存 储 库 协调 ， 并 把 
工作 保存 到 本 地 临时 工作 数据 库 ; 

更 新 一 一 先 获 取 到 数据 库 的 连接 ， 再 获取 到 主 存储 库 的 连接 。 从 临 
时 工作 数据 库 中 读 取 数据 ， 再 发 送 给 主 存储 库 。 

如 采用 户 数 量 多 于 凶 的 大 小 会 怎样 ? 假设 每 个 地 中 能 容纳 10 个 资 
源 。 

有 10 个 用 户 答 试 创建 ， 获 取 了 10 个 数据 库 连 接 ， 每 个 线程 在 获取 到 
数据 库 连 接 之 后 、 获 取 到 主 存 储 库 连接 之 前 都 被 打 盎 ; 

有 10 个 用 户 尝 试 更 新 ， 获 取 了 10 个 主 存储 库 连 接 ， 每 个 线程 在 获取 
到 主 存储 库 连 接 之 后 、 获 取 到 数据 库 连接 之 前 都 会 被 打 断 ; 

现在 那 10 个 “创建 ?线程 必须 等 待 获取 主 存 储 库 连 接 ， 但 那 10 个 “更 
新 ”线程 必须 等 待 获取 数据 库 连 接 ; 

死 锁 。 系 统 永远 无 法 恢复 。 

这 听 起 来 不 太 会 出 现 ， 但 谁 会 想 要 一 个 每 隅 一 周 就 僵 在 那里 不 动 的 
系统 呢 ? 谁 想 要 调试 出 现 了 难以 复 现 的 症状 的 系统 呢 ? 这 种 问题 突然 友 
生 ， 然 后 得 花 上 好 几 个 星期 才能 解决 。 

典型 的 “解决 方案 ?是 加 入 调试 语句 ， 发 现 问题 。 当 然 ， 调 试 语句 对 
代码 的 修改 足以 令 死 锁 在 不 同情 况 下 发 生 ， 而 且 要 几 个 月 后 才 会 再 出 现 




















[4]. 

要 真正 地 解决 死 锁 问题 ， 我 们 需要 理解 死 锁 的 原因 。 死 锁 的 发 生 需 
要 4 个 条 件 : 

HJF; 

上 锁 及 等 待 ; 

无 抢先 机 制 |; 

循环 等 待 。 


A.6.1 LF 
当 多 个 线程 需要 使 用 同一 资源 ， 且 这 些 资源 满足 下 列 条 件 时 ， 互 斥 
无 法 在 同一 时 间 为 多 个 线程 所 用 ; 
数量 上 有 限制 。 
这 种 资源 的 第 见 例子 是 数据 库 连 接 、 打 开 后 用 于 写 入 的 文件 、 记 录 


锁 或 是 信号 量 。 





A.6.2 FRS 


当 茶 个 线程 获取 一 个 资源 ， 在 获取 到 其 他 全 部 捷 需 资源 并 完成 其 工 
作 之 前 ， 不 会 释放 这 个 资源 。 


A.6.3 无 抢先 机 制 


线程 无 法 从 其 他 线程 处 夺取 资源 。 一 个 线程 持 有 资源 时 ， 其 他 线程 
获得 这 个 资源 的 唯一 手段 就 是 等 待 该 线程 释放 资源 。 


A.6.4 (I Y SEE BE 





这 也 被 称 为 “死命 拥抱 ”。 想 象 两 个 线程 ，T1 和 T2， 还 有 两 个 资源 ， 
R1 和 R2。T1 拥 有 R1，T2 拥 有 R2。T1 需 要 R2，T2 需 要 R1。 如 此 就 出 现 
了 如 图 A-3 所 示 的 情形 。 

这 4 种 条 件 都 是 死 锁 所 必需 的 。 只 要 其 中 一 个 不 满足 ， 死 锁 就 不 会 
发 生 。 


s 线程 1 
e, á Aa 
/ 


资源 2 资源 | 
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/ 
e€ Py 
& FA. 


^ 
线程 2 一 


图 A-3 循环 等 待 


A.6.5 ^ EJF 





避免 死 锁 的 一 种 策略 是 规避 互 斥 条 件 。 你 可 以 : 
使 用 允许 同时 使 用 的 资源 ， 如 AtomicInteger; 
增加 资源 数量 ， 使 其 等 于 或 大 于 苋 争 线程 的 数量 ; 











在 获取 资源 之 前 ， 检 查 是 否 可 用 。 

Nee, SBMA EN. BAREIS EAL. MESSER 
FS Pas URL UR METE AT BRE SG RARA NT, M5 
有 3 个 其 他 条 件 呢 。 








A.6.6 ^^ E BUE SERE 


如 果 拒 绝 等 待 ， 就 能 消除 死 锁 。 在 获得 资源 之 前 检查 资源 ， 如 果 遇 
PTAC, RBA CR, ERKE. 

这 种 手段 带 来 几 个 潜在 问题 : 

线程 饥饿 一 一 东 个 线程 一 直 无 法 获得 它 所 需 的 资源 《〈 它 可 能 需要 某 
种 很 少 能 同时 获得 的 资源 组 合 〉; 

活 锁 一 一 几 个 线程 可 能 会 前 后 相连 地 要 求 获 得 某 个 资源 ， 然 后 再 释 
放 一 个 资源 ， 如 此 循环 。 这 在 单纯 的 CPU 任务 排列 算法 中 尤其 有 可 能 
现 《〈 想 想 嵌 入 式 设 备 或 单纯 的 手写 线程 平衡 算法 ) 。 

二 者 都 能 导致 较 兰 的 吞吐 量 。 第 一 个 的 结果 是 CPU 利用 率 低 ， 第 二 
个 的 结果 是 较 高 但 无 用 的 CPU 利用 率 。 

尽管 这 种 策略 听 起 来 没 效 率 ， 但 也 好 过 没有 。 至 少 ， 如 果 其 他 方案 
不 委 效 ， 这 种 手段 几乎 总 可 以 用 上 。 


A.6.7 满足 抢先 机 制 


避 倪 死 锁 的 男 一 集 略 是 允许 线程 从 其 他 线程 上 夺取 资源 。 这 通常 利 
用 一 种 简单 的 请 求 机 制 来 实现 。 当 线程 发 现 资 源 繁 忙 ， 就 要 求 其 拥有 者 
释放 之 。 如 果 拥 有 者 还 在 等 每 其 他 资源 ， 束 释放 全 部 资源 并 重新 来 过 。 

这 和 上 一 种 手段 相似 ， 但 好 处 是 允许 线程 等 每 资源 。 这 减少 了 线程 
重新 局 动 的 次 数 。 不 过 ， 管 理 所 有 请 求 可 要 论点 心思 。 








A.6.8 不 做 循环 等 待 


这 是 避免 死 锁 的 最 常用 手段 。 对 于 多 数 系 统 ， 它 只 要 求 一 个 为 各 方 
认同 的 约定 。 
在 上 面 的 例子 中 线程 1 同时 需要 资源 1 和 资源 2、 线 程 2 同时 需要 资源 
2 和 资源 1， 只 要 强制 线程 1 和 线程 2 以 同样 次 序 分 配 资源 ， 循 环 等 待 就 不 
会 发 生 。 
普遍 地 ， 如 果 所 有 线程 都 认同 一 种 资源 获取 次 序 ， 并 按照 这 种 次 
序 获取 资源 ， 死 锁 就 不 会 发 生 。 就 像 其 他 策略 一 样 ， 这 也 会 有 问题 : 
TR ERATE STRE n.4: 一 开始 获取 的 资源 
能 在 最 后 才 会 用 到 。 能 导致 资源 不 必要 地 被 长 时 间 锁 定 ; 
如 果 第 二 个 资源 的 ID 来 自 对 第 一 个 资 
源 操作 的 结果 ， 获 取 次 序 也 无 从 谈 起 。 
有 许多 避免 死 锁 的 方法 。 有 些 会 导致 饥饿 ， 另 外 一 些 会 导致 对 CPU 
能 力 的 大 量 耗 费 和 降低 响应 率 。TANSTAAFLI5]! 
将 解决 方案 中 与 线程 相关 的 部 分 分 隔 出 来 ， 再 加 以 调整 和 试验 ， 是 
获得 判断 最 佳 策 略 所 需 的 洞 见 的 正道 





A.7 测试 多 线程 代 亿 








怎么 才能 编写 显示 以 下 代码 有 错 的 测试 呢 ? 
01: public class ClassWithThreadingProblem 1 


02: int nextId; 

03: 

04: public int takeNextId() { 
05: return nextId++; 

06: j 

07: ] 


下 面 是 对 能 证 明 上 列 代 码 有 错 的 测试 的 摘 述 : 
记 住 nextId 的 当前 值 ; 

创建 两 个 线程 ， 每 个 都 调用 takeNextId( ) 一 次 ; 

验证 nextId 比 开始 时 大 2; 

持续 运行 ， 直 至 发 现 nextId 只 比 开始 时 大 1 为 止 。 
代码 清单 A-2 展 示 了 这 样 一 个 测试 : 

代码 清单 A-2 ClassWithThreadingProblemTest.java 
01: package example; 


02: 

03: import static org.junit.Assert.fail; 
04: 

05: import org.junit.Test; 

06: 


07: public class ClassWithThreadingProblemTest { 


08: 

09: 
Exception { 

10: 


@Test 


public void twoThreadsShouldFailEventually() throws 


final ClassWithThreadingProblem 


classWithThreadingProblem 


11: 
12: 
13: 
14: 
15: 
16: 
17: 
18: 
19: 
20: 
21: 
22: 
23: 
24: 
25: 
26: 
27: 
28: 
29: 
30: 
31: 


= new ClassWithThreadingProblem(); 


Runnable runnable = new Runnable) 1| 
public void run() { 
classWithThreadingProblem.takeNextId(); 


ie 


for (inti=0; i<50000;++i) { 
int startingId = classWithThreadingProblem.lastId; 
int expectedResult = 2 + startingId; 


Thread tl = new Thread(runnable); 
Thread t2 = new Thread(runnable); 
t1.start(); 
t2.start(); 
t1.join(); 
t2.join(); 


int endingld = classWithThreadingProblem.lastId; 


if (endingid !=  expectedResult) 


32: return; 


35: fail("Should have exposed a threading issue 
but it did not."); 
36: } 





表 A-3 代码 清单 A-2 的 注解 




















代码 行 描述 

10 创建 ClassWithThreadingProblem 的 单个 实体 。 注 意 ， 必 须 使 用 final 关键 字 ， 因 为 要 在 一 个 匿 
名 内 部 类 中 用 到 它 

12~16 创建 一 个 匿名 内 部 类 ， 该 类 用 到 ClassWithThreadingProblem 的 单个 实体 

















18 运行 这 段 代 码 “足够 多 ”次 以 展示 代码 失败 ， 但 不 要 多 到 “ 花 太 长 时 间 ”。 这 是 种 平衡 行为 ; 
我 们 不 想 等 太 久 。 选 择 这 个 数字 有 点 难 一 一 尽管 我 们 稍 后 会 看 到 能 够 极 大 地 降低 这 个 数字 

19 记 住 开始 时 的 值 。 这 个 测试 试图 证 明 ClassWithThreadingProblem 中 的 代码 有 错误 。 如 果 测 试 
通过 ， 它 就 证 明了 这 一 点 。 如 果 测 试 失败 ， 它 就 没 能 证 明代 码 出 错 





20 我 们 期 望 最 终 值 比 当前 值 大 2 


22 一 23 创建 两 个 线程 ， 都 使 用 我 们 在 第 12-16 行 创建 的 对 象 。 这 样 两 个 线程 就 有 可 能 用 到 
ClassWithThreadingProblem 的 单个 实体 ， 互 相干 涉 














24-25 开始 运行 两 个 线程 
26 一 27 在 检查 结果 之 前 等 待 两 个 线程 结束 
29 记录 真实 的 最 终 值 








31 一 32 endingld 是 否 与 期 待 值 不 一 样 ? 如 果 是 ， 测 试 结束 一 一 我 们 已 经 证 明了 代码 有 错误 。 如 果 不 


A, 再 试 一 次 


35 到 达 这 一 步 ， 测 试 无 法 证 明 产 品 代码 在 “合理 范围 ”的 时 间 内 出 错 ; 测试 失败 了 。 要 么 是 代 
码 没 错 ， 要 么 是 没有 运行 足够 多 次 ， 错 误 条 件 还 没 满足 


这 个 测试 当然 设置 了 满足 并 发 更 新 问题 发 生 的 条 件 。 不 过 ， 问 题 发 
生得 如 此 频繁 ， 测 试 也 就 极 有 可 能 侦 测 不 到 。 

实际 上 ， 要 真正 侦 测 到 问题 ， 需 要 将 循环 数量 设置 到 100 万 次 以 
上 。 即 便 是 这 样 ， 在 10 个 100 万 次 循环 的 执行 中 ， 错 误 也 只 发 生 了 一 
次 。 这 意味 着 我 们 可 能 要 把 循环 次 数 设 置 为 超过 亿 次 才能 获得 可 靠 的 失 
败 证 明 。 要 等 多 和 久 呢 ? 

即便 我 们 调 优 测 试 ， 在 单 台 机 器 上 得 到 可 靠 的 失败 证 明 ， 我 们 可 能 
还 需要 用 不 同 的 值 来 重新 设置 测试 ， 得 到 在 其 他 机 器 、 操 作 系统 或 不 同 
版 本 的 JVM 上 的 失败 证 明 。 

而 且 这 只 是 个 简单 问题 。 如 果 连 这 个 简单 问题 都 无 法 轻易 获得 出 错 
证 明 ， 我 们 怎么 能 真正 侦 测 复杂 问题 呢 ? 

我 们 能 用 什么 手段 来 证 明 这 个 简单 错误 呢 ? 而 且 ， 更 重要 的 是 ， 我 
们 如 何 能 写 出 证 明 更 复杂 代码 中 的 错误 的 测试 呢 ? 我 们 怎样 才能 在 不 知 

















道 从 何 处 着 手 时 知道 代码 是 否 出 错 了 呢 ?” 下 面 是 一 些 想 法 : 

蒙特 卡 洛 测 试 。 测 试 要 灵活 ， 便 于 调整 。 多 次 运行 测试 在 一 台 
测试 服务 器 上 一 一 随机 改变 调整 值 。 如 果 测 斌 失败， 代码 束 有 错 。 确 保 
及 早 编写 这 些 测 试 ， 好 让 持续 集成 服务 器 尽快 开始 运行 测试 。 另 外 ， 确 
认 小 心 记录 了 在 何 种 条 件 下 测试 失败 。 

在 每 种 目标 部 署 平 台 上 运行 测试 。 重 复 运行 。 持 续 运 行 。 测 试 在 不 
失败 的 前 提 下 运行 得 越久 ， 就 越 能 说 明 : 

-生产 代码 正确 ; 

或 ; 

-测试 不 足以 暴露 问题 。 

在 另 一 台 有 不 同 负载 的 机 器 上 运行 测试 。 能 模拟 生产 环境 的 负载 ， 
WRM o 

即便 你 做 了 所 有 这 些 ， 还 是 不 见得 有 很 好 的 机 会 发 现代 人 码 中 的 线程 
问题 。 最 阴险 的 问题 拥有 很 小 的 截面 ， 在 十 亿 次 执行 中 只 会 发 生 一 次 。 
这 类 错误 是 复杂 系统 的 亚 梦 。 























IBM 提 供 了 一 个 名 为 ConTest 的 工具 [6]。 它 能 对 类 进行 装置 ， 令 非 
线程 安全 代码 更 有 可 能 失败 。 

我 们 与 BM 或 开发 ConTest 的 团队 没有 直接 关系 。 有 位 同事 发 现 了 
这 个 工具 。 在 用 了 几 分 钟 后 ， 我 们 发 现 自 己 发 现 线程 问题 的 能 力 得 到 了 
很 大 提升 。 

下 面 是 使 用 ConTest 的 简要 步骤 : 

编写 测试 和 生产 代码 ， 确 保有 专门 模拟 多 用 户 在 多 种 负载 情况 下 操 
作 的 测试 ， 如 上 文 所 述 ; 

用 ConTest 装 置 测 试 和 生产 代码 ; 

运行 测试 。 

用 ConTest 装 置 代 码 后 ， 原 本 千 万 次 循环 才能 暴露 一 个 错误 的 比率 
提升 到 30 次 循环 束 能 找到 错误 。 以 下 是 装置 代码 后 的 几 次 测试 运行 结果 
值 : 13、23、0、54、16、14、6、69、107、49 和 2。 显 然 装置 后 的 类 更 
加 容易 和 可 靠 地 被 证 明 失 败 。 











A.9 小 结 


本 章 只 是 在 并 发 编程 广阔 而 可 怕 的 领地 上 的 短暂 逗留 村 了 。 我 们 只 
触及 了 地 表 。 我 们 在 这 里 强调 的 ， 只 是 保持 并 发 代码 整洁 的 一 些 规程 ， 
如 果 要 编写 并 发 系统 ， 还 有 许多 东西 要 学 。 建 议 从 Doug Lea 的 大 作 
Concurrent Programming in Java:Design Principles and Patterns 开 始 [7]。 

在 本 章 中 ， 我 们 谈 到 并 发 更 新 ， 还 有 清理 及 避免 同步 的 规程 。 我 们 
谈 到 线程 如 何 提升 与 JO 有 关 的 系统 的 吞吐 量 ， 展 示 了 获得 这 种 提升 的 
整洁 技术 。 我 们 谈 到 死 锁 及 干将 地 避免 死 锁 的 规程 。 最 后 ， 我 们 谈 到 通 
过 装置 代码 暴露 并 发 问题 的 策略 。 

















代码 清单 A-3 Server.java 

package com.objectmentor.clientserver.nonthreaded; 

import java.io.IOException; 

import java.net.ServerSocket; 

import java.net.Socket; 

import java.net.SocketException; 

import common.MessageUtils; 

public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 


public Server(int port, int millisecondsTimeout) throws IOException 


serverSocket = new ServerSocket(port); 

serverSocket.setSoTimeout(millisecondsTimeout); 
j 
public void run() 1 

System.out.printf(" Server Starting"); 

while (keepProcessing) 1 

try { 
System.out.printf("accepting client\n"); 


Socket socket = serverSocket.accept(); 


System.out.printf("got client\n"); 
process(socket); 

} catch (Exception e) { 
handle(e); 


} 
private void handle(Exception e) { 
if (!(e instanceof SocketException)) { 


e.printStackTrace(); 


} 
public void stopProcessing() { 
keepProcessing = false; 
closeIgnoringException(serverSocket); 
} 
void process(Socket socket) { 
if (socket == null) 
return; 
try { 
System.out.printf("Server: getting message\n"); 
String message = MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 


System.out.printf("Server: sent\n"); 


closeIgnoringException(socket); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 

} catch (IOException ignore) { 

} 
} 


private void closeIgnoringException(ServerSocket serverSocket) { 
if (serverSocket != null) 
try { 
serverSocket.close(); 
} catch (IOException ignore) { 
} 


} 

代码 清单 A-4 ClientTest.java 

package com.objectmentor.clientserver.nonthreaded; 
import java.io.IOException; 

import java.net.ServerSocket; 

import java.net.Socket; 

import java.net.SocketException; 


import common.MessageUtils; 


public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 


public Server(int port, int millisecondsTimeout) throws IOException 


serverSocket = new ServerSocket(port); 
serverSocket.setSoTimeout(millisecondsTimeout); 
} 
public void run() { 
System.out.printf("Server Starting\n"); 
while (keepProcessing) { 
try { 
System.out.printf("accepting client\n"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process(socket); 
} catch (Exception e) { 
handle(e); 


} 
private void handle(Exception e) { 
if (!(e instanceof SocketException)) { 


e.printStackTrace(); 


j 
public void stopProcessing() 1 


keepProcessing = false; 
closeIgnoringException(serverSocket); 
} 
void process(Socket socket) { 
if (socket == null) 
return; 
try { 
System.out.printf("Server: getting message\n"); 
String message = MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 
} catch (IOException ignore) { 
} 


private void closelgnoringException(ServerSocket serverSocket) { 


if (serverSocket != null) 
try { 
serverSocket.close(); 
} catch (IOException ignore) { 
j 


j 
代码 清单 A-5 MessageUtils.java 
package common; 
import java.io.IOException; 
import java.io.InputStream; 
import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 
import java.io.OutputStream; 
import java.net.Socket; 
public class MessageUtils { 
public static void sendMessage(Socket socket, String message) 
throws IOException 1 
OutputStream stream = socket.getOutputStream(); 
ObjectOutputStream oos = new ObjectOutputStream(stream); 
oos.writeUTF(message); 
oos.flush(); 
} 
public static String getMessage(Socket socket) throws IOException { 
InputStream stream = socket.getInputStream(); 
ObjectInputStream ois = new ObjectInputStream(stream); 


return ois.readUTF(); 





TRAE OCA TE RAE. A READER ET BI AY Pr 
的 代码 行 用 粗 体 标 出 ) : 
void process(final Socket socket) { 
if (socket == null) 
return; 
Runnable clientHandler = new Runnable() { 
public void run() { 
try { 
System.out.printf("Server: getting message\n"); 
String message = MessageUtils.getMessage(socket); 
System.out.printf("Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf("Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
|? 


Thread clientConnection - new Thread(clientHandler); 


clientConnection.start(); 











DIRE: 你 可 以 自行 验证 修改 之 前 和 之 后 的 代码 。 复 但 前 文 的 非 多 线 
程 代码 。 复 但 之 后 的 多 线程 代码 。 


LI 这 说 得 有 点 简单 了 。 鉴 于 讨论 的 目的 ， 我 们 就 用 这 个 简化 模 
型 好 了 了 。 


BILE: 实际 上 ，Iterator 接 口 天 生 不 是 线程 安全 的 。 它 并 不 为 多 线程 
而 设计 ， 所 以 出 现 这 种 情况 也 不 奇怪 。 


[41. 原 注 : 例如 ， 有 人 添加 了 一 些 调试 输出 ， 问 题 “ 不 见 了 ”。 调 试 代 
码 “ 修 正 ” 了 问题 ， 其 实 问 题 还 在 系统 中 存在 。 


BLEE: 世上 没有 免费 的 午餐 (There ain't no such thing as a free 
lunch) 。 











[6]. 原 注 : 


http://www. haifa.ibm.com/projects/verification/contest/index.html. 


[Z]. 原 注 : JL [Lea99]p.191. 


[<xB org.ifree.date.SerialDate 


代码 清单 B-1 SerialDate.Java 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or 
modify it 

10 * under the terms of the GNU Lesser General Public 
License as published by 

11 * the Free Software Foundation; either version 2.1 of the License, 
Or 

12 * (at your option) any later version. 

13 * 


14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY 

16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
Lesser General Public 

17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser 
General Public 

20 * License along with this library; if not, write to the Free 
Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, 

22 * USA. 

ga 

24 * [Java is a trademark or registered trademark of Sun 
Microsystems, Inc. 

25 *inthe United States and other countries.] 

26 * 

DI sh ilo cca 

28 *SerialDate.java 

D9 E SR 

30 *(C) Copyright 2001-2005, by Object Refinery Limited. 

dl S5 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 

34 * 


35 * $Id: SerialDate.java,v 1.7 2005/11/03 09:25:17 mungady 
Exp $ 

36 * 

37 * Changes (from 11-Oct-2001) 

DO 1 

39 * 11-Oct-2001 : Re-organised the class and moved it to new 
package 

40 * com.jrefinery.date (DG); 

41 * 05-Nov-2001 : Added a getDescription() method, and 
eliminated NotableDate 

42 * class (DG); 

43 * 12-Nov-2001 : IBD requires setDescription() method, now 


that NotableDate 

44 * class is gone (DG); Changed 
getPreviousDayOfWeek(), 

45 * getFollowingDayOfWeek() and 
getNearestDayOfWeek() to correct 

46 * bugs (DG); 


47 * 05-Dec-2001 : Fixed bug in SpreadsheetDate class (DG); 

48 * 29-May-2002 : Moved the month constants into a separate 
interface 

49 * (MonthConstants) (DG); 

50 * 27-Aug-2002 : Fixed bug in addMonths() method, thanks to 
N???levka Petr (DG); 

51 * 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

52 * 13-Mar-2003: Implemented Serializable (DG); 

53 * 29-May-2003 : Fixed bugin addMonths method (DG); 


54 * 04-Sep-2003 : Implemented Comparable. Updated the 
isInRange javadocs (DG); 
55 * 05-Jan-2005 : Fixed bug in addYears() method (1096282) 


(DG); 
56 * 
pu. M 
58 
59 package org.jfree.date; 
60 


61 import java.io.Serializable; 

62 import java.text.DateFormatSymbols; 

63 import java.text.SimpleDateFormat; 

64 import java.util.Calendar; 

65 import java.util.GregorianCalendar; 

66 

67:/** 

68 * An abstract class that defines our requirements for 
manipulating dates, 

69 * without tying downa particular implementation. 

70 # <P> 

71 * Requirement 1: match atleast what Excel does for dates; 

72 * Requirement 2: class is immutable; 

73 * <P> 

74 * Why not just use java.util.Date? We will, when it makes 
sense. At times, 

75 * java.util.Date can be *too* precise - it represents an instant 


in time, 


76 * accurate to 1/1000th of a second (with the date itself 
depending on the 

77 * time-zone). Sometimes we just want to represent a 
particular day (e.g. 21 

78 * January 2015) without concerning ourselves about the time of 
day, orthe 

79 * time-zone, or anything else. That's what we've defined 
SerialDate for. 

80 * <P> 

81 * Youcancall getInstance() to get a concrete subclass of 
SerialDate, 

82 * without worrying about the exact implementation. 

83 * 

84 * @author David Gilbert 

85 */ 

86 public abstract class SerialDate implements Comparable, 

87 


Serializable, 

88 
MonthConstants 1 

89 

90 /** For serialization. — */ 

91 private static final long serial VersionUID 
= -293716040467423637L; 

92 

93 /** Date format symbols. */ 


94 public static final DateFormatSymbols 


95 DATE_FORMAT_SYMBOLS = new 
SimpleDateFormat().getDateFormatSymbols(); 


96 

97 /** The serial number for 1 January 1900. */ 

98 public static final int SERIAL. LOWER, BOUND = 2; 

99 

100 /** The serial number for 31 December 9999. */ 

101 public static final int SERIAL. UPPER. BOUND = 2958465; 

102 

103 /** The lowest year value supported by this date 
format. */ 


104 public static final int MINIMUM YEAR SUPPORTED - 
1900; 

105 

106 /** The highest year value supported by this date 
format. */ 

107 public static final int MAXIMUM YEAR SUPPORTED = 
9999; 


108 

109 /** Useful constant for Monday. Equivalent to 
java.util.Calendar. MONDAY.  */ 

110 public static final int MONDAY - Calendar. MONDAY; 

111 

112 [ER 

113 * Useful constant for Tuesday. Equivalent to 


java.util.Calendar. TUESDAY. 
114 di 


115 public static final int TUESDAY = Calendar. TUESDAY; 


116 

117 ERs 

118 * Useful constant for Wednesday. Equivalent to 

119 * java.util.Calendar. WEDNESDAY. 

120 mi 

121 public static final int WEDNESDAY = 
Calendar. WEDNESDAY; 

122 

123 prm 

124 * Useful constant for Thrusday. Equivalent to 
java.util. Calendar. THURSDAY. 

125 e^ 

126 public static final int THURSDAY = 
Calendar. THURSDAY; 

127 

128 /** Useful constant for Friday. Equivalent to 
java.util.Calendar.FRIDAY. */ 

129 public static final int FRIDAY = Calendar.FRIDAY; 

130 

131 [Re 

132 * Useful constant for Saturday. Equivalent to 
java.util.Calendar.SATURDAY. 

133 */ 

134 public static final int SATURDAY = 


Calendar. SATURDAY; 
135 


136 /** Useful constant for Sunday. Equivalent to 
java.util.Calendar.SUNDAY.  */ 


137 public static final int SUNDAY = Calendar.SUNDAY; 

138 

139 /** The number of days in each month in non leap years. */ 

140 static final intl] LAST DAY OF MONTH = 

141 (0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}; 

142 

143 /** The number of days in a (non-leap) year up to the 
end ofeach month. */ 

144 static final int[] 
AGGREGATE_DAYS_TO_END_OF_MONTH = 

145 {0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 
334, 365}; 

146 

147 /** The number of days in a year up to the end of the 
preceding month. */ 

148 static final int[] 
AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH = 

149 {0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 
304, 334, 365}; 

150 

151 /** The number of days ina leap year up to the end of each 
month. */ 

152 static final int[] 


LEAP YEAR AGGREGATE DAYS TO END OF MONTH = 
153 (0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 


335, 366}; 


154 

155 (RE 

156 * The number of days in a leap year up to the end of 
the preceding month. 

157 m 

158 static final  int[] 

159 


LEAP_YEAR_AGGREGATE DAYS_TO_END_OF_PRECEDING_MONT 


160 {0, 0, 31, 60, 91, 121, 152, 182, 213, 244, 
274, 305, 335, 366}; 

161 

162 /** A useful constant for referring to the first week in a 
month. */ 

163 public static final int FIRST_WEEK_IN_MONTH = 1; 

164 

165 /** A useful constant for referring to the second week 


in a month. */ 
166 public static final int SECOND_WEEK_IN_MONTH = 2; 


167 

168 /** A useful constant for referring tothe third week in a 
month. */ 

169 public static final int THIRD_WEEK_IN_MONTH = 3; 

170 

171 /** A useful constant for referring to the fourth week 


in a month. */ 


172 public static final int FOURTH_WEEK_IN_MONTH = 4; 


173 

174 /** A useful constant for referring to the last week in a 
month. */ 

175 public static final int LAST_WEEK_IN_MONTH =0; 

176 

177 /** Useful range constant. */ 

178 public static final int INCLUDE_NONE = 0; 

179 

180 /** Useful range constant. */ 

181 public static final int INCLUDE_FIRST = 1; 

182 

183 /** Useful range constant. */ 

184 public static final int INCLUDE_SECOND = 2; 

185 

186 /** Useful range constant. */ 

187 public static final int INCLUDE_BOTH = 3; 

188 

189 [es 

190 * Useful constant for specifying a day of the week 
relative toa fixed 

191 * date. 

192 sii 

193 public static final int PRECEDING = -1; 

194 

195 pm 


196 * Useful constant for specifying a day of the week relative 


toa fixed 
197 
198 
199 
200 
201 
202 
toa fixed 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 


* date. 
2 
public static final int NEAREST = 0; 


[PE 


* Useful constant for specifying a day of the week relative 


* date. 
m 
public static final int FOLLOWING = 1; 


/** A description for the date. */ 


private String description; 


Li 
* Default constructor. 
*/ 
protected SerialDate() { 
} 


/ 米 米 


* Returns <code>true</code> if the supplied integer 


code repre sents a 


218 
otherwise. 
219 


* valid day-of-the-week, and <code>false</code> 


* @param code the code being checked for validity. 


* 


* @return <code>true</code> if the supplied integer 


code represents a 


223 


* valid day-of-the-week, and 


<code>false</code> otherwise. 


224 
225 


226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 


si, 
public static boolean isValidWeekdayCode(final int code) 


switch(code) { 
case SUNDAY: 
case MONDAY: 
case TUESDAY: 
case WEDNESDAY: 
case THURSDAY: 
case FRIDAY: 
case SATURDAY: 

return true; 

default: 


return false; 


[E 


* Converts the supplied string to a day of the week. 


244 


245 * @params a string representing the day of the week. 
246 * 
247 * (greturn <code>-1</code> if the string is not 


convertable, the day of 


248 “i the week otherwise. 

249 ui 

250 public static int stringToWeekdayCode(String s) { 

25] 

252 final String] shortWeekdayNames 

253 = 
DATE_FORMAT_SYMBOLS.getShortWeekdays(); 

254 final String[] weekDayNames = 
DATE_FORMAT_SYMBOLS.getWeekdays(); 

255 

256 int result = -1; 

257 s = s.trim(); 

258 for (int i = 0; i < weekDayNames.length; i++) { 

259 if (s.equals(shortWeekdayNames[i])) { 

260 result = i; 

261 break; 

262 j 

263 if (s.equals(weekDayNamesli])) 1 

264 result = i; 

265 break; 

266 } 


267 } 


268 return result; 


269 

270 } 

271 

272 JER 

273 * Returns a string representing the supplied day-of-the- 
week. 

274 * <P> 

275 * Need to find a better approach. 

276 = 

277 * @param weekday the day of the week. 

278 x 

279 * @return a string representing the supplied day-of-the- 
week. 

280 E 

281 public static String weekdayCodeToString(final int 
weekday) 1 

282 

283 final String[] weekdays = 
DATE_FORMAT_SYMBOLS.getWeekdays(); 

284 return weekdays[ weekday]; 

285 

286 } 

287 

288 JER 

289 * Returns an array of month names. 


290 P 


291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
month names 
303 
304 
305 
306 
307 
308 
309 
310 


* @return an array of month names. 
mi 
public static String[] getMonths() 1 


return getMonths(false); 


/ 米 米 


* Returns an array of month names. 


* 


* @param shortened a flag indicating that shortened 
should 


* be returned. 


* 

* @return an array of month names. 

£4 

public static String[] getMonths(final boolean shortened) 1 


if (shortened) 1 


return 


DATE FORMAT SYMBOLS.getShortMonths(); 


311 
312 
313 
314 
315 


} 


else { 
return DATE_FORMAT_SYMBOLS.getMonths(); 


} 


316 
317 
318 
319 


valid month. 


320 
321 
322 
323 


code represents a 


324 
325 
326 
327 
328 
320 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 


* Returns true if the supplied integer code represents a 


* @param code the code being checked for validity. 


* @return <code>true</code> if the supplied integer 


valid month. 


public static boolean isValidMonthCode(final int code) { 


switch(code) { 


case JANUARY: 
case FEBRUARY: 
case MARCH: 
case APRIL: 

case MAY: 

case JUNE: 

case JULY: 

case AUGUST: 
case SEPTEMBER: 
case OCTOBER: 
case NOVEMBER: 
case DECEMBER: 


341 return true; 


342 default: 

343 return false; 

344 } 

345 

346 } 

347 

348 p 

349 * Returns the quarter forthe specified month. 
350 x 

351 * @param code the month code (1-12). 

352 rs 

353 * @return the quarter thatthe month belongs to. 
354 * @throws java.lang.IllegalArgumentException 
355 ay 

356 public static int monthCodeToQuarter(final int code) { 
357 

358 switch(code) { 

359 case JANUARY: 

360 case FEBRUARY: 

361 case MARCH: return 1; 

362 case APRIL: 

363 case MAY: 

364 case JUNE: return 2; 

365 case JULY: 

366 case AUGUST: 


367 case SEPTEMBER: return 3; 


368 case OCTOBER: 


369 case NOVEMBER: 

370 case DECEMBER: return 4; 

371 default: throw new IllegalArgumentException( 

372 "SerialDate.monthCodeToQuarter: invalid 
month code."); 

373 } 

374 

375 } 

376 

377 [es 

378 * Returns a string representing the supplied month. 

379 * <P> 

380 * The string returned is the long form of the month 
name taken from the 

381 * default locale. 

382 " 

383 * @param month the month. 

384 * 

385 * @returna string representing the supplied month. 

386 dii 

387 public static String monthCodeToString(final int month) 
{ 

388 

389 return monthCodeToString(month, false); 

390 


391 } 


392 
393 
394 
395 
396 


[E 
* Returnsa string representing the supplied month. 
* <P> 


* The string returned is the long or short form of 


the month name taken 


397 
398 
399 
400 


* from the default locale. 


* 


* @param month the month. 


* @param shortened if <code>true</code> return the 


abbreviation of the 


401 
402 
403 
404 
405 
406 
407 
final boolean 
408 
409 
410 
411 
412 


x month. 

* 

* @return a string representing the supplied month. 

* @throws java.lang.IllegalArgumentException 

n: 

public static String monthCodeToString(final int month, 


shortened) { 


// check arguments... 
if (!isValidMonthCode(month)) { 
throw new IllegalArgumentException( 


"SerialDate.monthCodeToString: month 


outside valid range."); 


413 
414 


} 


415 final String[] months; 


416 

417 if (shortened) 1 

418 months - 
DATE FORMAT SYMBOLS.getShortMonths(); 

419 } 

420 else { 

421 months = 
DATE_FORMAT_SYMBOLS.getMonths(); 

422 } 

423 

424 return months[month - 1]; 

425 

426 } 

427 

428 [oe 

429 * Converts a_ string to a month code. 

430 * <P> 

431 * This method will return one of the constants 
JANUARY, FEBRUARY,..., 

432 * DECEMBER that corresponds to the string. If the 
string is not 

433 * recognised, this method returns  -1. 

434 * 

435 * @params the string to parse. 

436 * 


437 * @return <code>-1</code> if the string is not parseable, 


the month of the 


438 
439 
440 
441 
442 


à year otherwise. 
*/ 
public static int stringToMonthCode(String s) 1 


final String[] shortMonthNames 


DATE_FORMAT_SYMBOLS.getShortMonths(); 


443 


final String[ ] monthNames 


DATE FORMAT SYMBOLS.getMonths(); 


444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 


459 
460 


int result = -1; 


s = s.trim(); 


// first try parsing the string as an integer (1-12)... 
try 1 
result = Integer.parseInt(s); 
j 
catch (NumberFormatException e) 1 


// suppress 


// now search through the month names... 
if ((result< 1) || (result» 12)) { 


for (int i= 0; i< monthNames.length; 


if (s.equals(shortMonthNames[i])) { 


result=i+ 1; 


461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
valid 
476 
477 
478 
479 


break; 


} 

if (s.equals(monthNames[i])) { 
result=i+ 1; 
break; 


return result; 


[PE 


* Returns true if the supplied integer code represents a 


* week-in-the-month, and false otherwise. 


* 


* @param code the code being checked for validity. 


* @return <code>true</code> if the supplied integer 


code represents a 


480 
481 
482 
code) { 
483 
484 


m valid week-in-the-month. 
3 
public static boolean isValidWeekInMonthCode(final int 


switch(code) { 


485 case FIRST WEEK IN. MONTH: 


486 case SECOND WEEK IN MONTH: 

487 case THIRD WEEK. IN MONTH: 

488 case FOURTH WEEK IN MONTH: 

489 case LAST WEEK IN MONTH: return true; 

490 default: return false; 

491 } 

492 

493 } 

494 

495 PES 

496 * Determines whether or not the specified year is a 
leap year. 

497 * 

498 * (Dparam yyyy the year (inthe range 1900to 9999). 

499 T 

500 * (greturn <code>true</code> if the specified year is a 
leap year. 

501 */ 

502 public static boolean isLeapYear(final int yyyy) { 

503 

504 if((yyyy %4) !=0){ 

505 return false; 

506 } 

507 else if ((yyyy 96400) ==0){ 

508 return true; 


509 } 


510 else if ((yyyy 96100) ==0){ 
511 return false; 

512 } 

513 else { 

514 return true; 

515 } 

516 

517 } 

518 

519 pm 

520 * Returns the number of leap years from 1900 to the 


specified year 


521 * INCLUSIVE. 

522 * <P> 

523 * Note that 1900 is not a leap year. 

524 * 

525 * @param yyyy the year (inthe range 1900to 9999). 

526 di 

527 * @return the number of leap years from 1900 to the 
specified year. 

528 £^ 

529 public static int leap Y earCount(final int yyyy) { 

530 

531 final int leap4 = (yyyy - 1896)/4; 

532 final int leap100 = (yyyy - 1800) / 100; 

533 final int leap400 = (yyyy - 1600) / 400; 


534 return leap4 - leap100 + leap400; 


535 


536 } 

537 

538 in 

539 * Returns the number of the last day of the month, 
taking into account 

540 * leap years. 

541 x 

542 * @param month the month. 

543 * @param yyyy the year (inthe range 1900to 9999). 

544 tà 

545 * @return the number of the last day ofthe month. 

546 £^ 

547 public static int lastDayOfMonth(final int month, final int 
yyyy) 1 

548 

549 final int result = LAST DAY OF MONTHL[month]; 

550 if (month != FEBRUARY) { 

551 return result; 

552 } 

553 else if (isLeapYear(yyyy)) { 

554 return result+ 1; 

555 } 

556 else { 

557 return result; 

558 } 


559 


560 
561 
562 
563 


[E 


* Creates a new date by adding the specified number 


of days to the base 


564 
565 
566 
negative). 
567 
568 
569 
570 
571 
SerialDate 
572 
573 
574 
575 
576 
577 
578 
579 


of months to 


580 
581 
582 


* date. 


* 


* @param days the number of days to add (can be 


* @param base the base date. 

* 

* @returna new date. 

*/ 

public static SerialDate addDays(final int days, final 
base) { 


final int serialDayNumber = base.toSerial() + days; 


return SerialDate.createInstance(serialDayNumber); 


LI 
* Creates a new date by adding the specified number 
the base 
* date. 
* <P> 


* If the base date is close to the end of the month, the 


day on the result 


583 * may be adjusted slightly: 31 May +1 month = 30 
June. 

584 * 

585 * @param months the number of months to add (can 


be negative). 


586 * @param base thebase date. 

587 me 

588 * @returna new date. 

589 "m 

590 public static SerialDate addMonths(final int months, 

591 final 
SerialDate base) 1 

592 

593 final int yy = (12 * base.getYYYY() + 
base.getMonth() + months - 1) 

594 / 12; 

595 final int mm = (12 * base.getYYYY() + 
base.getMonth() +months - 1) 

596 % 12+ 1; 

597 final int dd = Math.min( 

598 base.getDayOfMonth(), 
SerialDate.lastDayOfMonth(mm, yy) 

599 y 

600 return SerialDate.createInstance(dd, mm, yy); 

601 


602 j 


603 


604 prm 

605 * Creates a new date by adding the specified number 
of years to the base 

606 * date. 

607 i 

608 * @param years the number of years to add (can be 
negative). 

609 * @param base thebase date. 

610 A 

611 * @return A new date. 

612 zi 

613 public static SerialDate addYears(final int years, final 
SerialDate base) 1 

614 

615 final int baseY = base.getY Y YY(); 

616 final int baseM - base.getMonth(); 

617 final int baseD = base.getDayOfMonth(); 

618 

619 final int targetY = baseY + years; 

620 final int targetD = Math.min( 

621 baseD, SerialDate.lastDayOfMonth(baseM, 
targetY) 

622 y; 

623 

624 return SerialDate.createInstance(targetD, baseM, 


targetY ); 


625 


626 } 

627 

628 [Be 

629 * Returns the latest date that falls on the specified 
day-of-the-week and 

630 * is BEFORE the base date. 

631 * 

632 * @param targetWeekday a code for the target  day-of- 
the-week. 

633 * @param base the base date. 

634 x 

635 * @return the latest date that falls onthe specified day- 
of-the-week and 

636 d is BEFORE the base date. 

637 */ 

638 public static SerialDate getPreviousDayOfWeek(final int 
targetWeekday, 

639 
final SerialDate base) { 

640 

641 // check arguments... 

642 if (!SerialDate.isValidWeekdayCode(targetWeekday)) 
{ 

643 throw new IllegalArgumentException( 

644 "Invalid day-of-the-week code." 


645 ji 


646 } 


647 

648 // find the date... 

649 final int adjust; 

650 final int baseDOW = base.getDayOfWeek(); 

651 if (baseDOW >  targetWeekday) { 

652 adjust = Math.min(0, targetWeekday  - 
baseDOW); 

653 } 

654 else { 

655 adjust = -7 十 Math.max(0, 
targetWeekday - baseDOW); 

656 } 

657 

658 return SerialDate.addDays(adjust, base); 

659 

660 } 

661 

662 p 

663 * Returns the earliest date that falls on the specified day- 
of-the-week 

664 * and is AFTER the base date. 

665 x 

666 * @param targetWeekday a code for the target day-of- 
the-week. 

667 * @param base thebase date. 


668 a 


669 * @return the earliest date that falls on the specified day- 


of-the-week 

670 * andis AFTER the base date. 

671 zi 

672 public static SerialDate getFollowingDayOfWeek(final int 
targetWeekday, 

673 
final SerialDate base) 1 

674 

675 // check arguments... 

676 if (!SerialDate.isValidWeekdayCode(targetWeekday)) 
{ 

677 throw new IllegalArgumentException( 

678 "Invalid day-of-the-week code." 

679 ); 

680 } 

681 

682 // find the date... 

683 final int adjust; 

684 final int baseDOW = base.getDayOfWeek(); 

685 if (baseDOW >  targetWeekday) 1 

686 adjust = 7 + Math.min(0, targetWeekday  - 
baseDOW); 

687 } 

688 else { 

689 adjust = Math.max(0,  targetWeekday - 


baseDOW); 


690 
691 
692 
693 
694 
695 
696 
week and is 
697 
698 
699 
week. 
700 
701 
702 
week and is 
703 
704 
705 
targetDOW, 
706 


return SerialDate.addDays(adjust, base); 


[E 


* Returns the date that falls on the specified day-of-the- 


* CLOSEST to the base date. 


* 


* @param targetDOW a code for the target day-of-the- 


* @param base the base date. 


* 


* (greturn the date that falls on the specified day-of-the- 


i CLOSEST to the base date. 
"i 
public static SerialDate getNearestDayOfWeek(final int 


final SerialDate base) { 


707 
708 
709 
710 
711 


// check arguments... 
if (!SerialDate.is ValidWeekdayCode(targetDOW)) { 
throw new IllegalArgumentException( 


"Invalid day-of-the-week code." 


712 
713 
714 
715 
716 
717 
718 
719 
720 
721 
722 
723 
724 
725 
726 
727 
728 
729 
730 
731 
732 
733 
734 
735 
base) { 
736 
737 


// find the date... 
final int baseDOW = base.getDayOfWeek(); 
int adjust = -Math.abs(targetDOW - baseDOW); 
if (adjust >= 4) { 
adjust= 7 - adjust; 
} 
if (adjust <= -4) { 
adjust = 7 + adjust; 
} 
return SerialDate.addDays(adjust, base); 


/ 米 米 


* Rolls the date forward to the last day of the month. 


* 


* @param base the base date. 

* 

* @retuma new serial date. 

si 

public SerialDate getEndOfCurrentMonth(final SerialDate 


final int last = SerialDate.lastDayOfMonth( 
base.getMonth(), base.getYYYY() 


738 ); 


739 return SerialDate.createInstance(last, 
base.getMonth(), base.getY Y Y Y()); 

740 } 

741 

742 prn 

743 * Returns a string corresponding to the week-in-the-month 
code. 

744 * <P> 

745 * Need to find a better approach. 

746 T 

747 * @param count an integer code representing the 


week-in-the-month. 


748 M 

749 * @retuma string corresponding to the week-in-the-month 
code. 

750 di; 

751 public static String weekInMonthToString(final int 
count) { 

752 

753 switch (count) { 

754 case SerialDate.FIRST_WEEK_IN_MONTH : return 
"First"; 

755 case SerialDate.SECOND WEEK IN MONTH 
return "Second"; 

756 case  SerialDate. THIRD WEEK. IN MONTH 


return "Third"; 


757 


return "Fourth"; 


758 
"Last"; 

759 

760 


invalid code."; 


761 
762 
763 
764 
765 
766 
767 
768 
769 
770 
771 
772 
773 
774 
775 
776 
777 
"Preceding"; 
778 


case SerialDate. FOURTH WEEK IN MONTH 


case SerialDate.,.AST WEEK IN MONTH : return 


default 
return "SerialDate.weekInMonthToString(): 


/ 米 米 
* Returnsa string representing the supplied ‘relative’. 
* <P> 


* Need to find a better approach. 


* 


* @param relative a constant representing the ‘relative’. 


* 


* @retuma string representing the supplied  'relative'. 
*/ 


public static String relativeToString(final int relative) 1 


switch (relative) { 
case SerialDate. PRECEDING : return 


case SerialDate. NEAREST 


return "Nearest"; 


779 case SerialDate FOLLOWING : return 
"Following"; 

780 default : return "ERROR : Relative To 
String"; 

781 } 

782 

783 } 

784 

785 [= 

786 * Factory method that returns an instance of some 


concrete subclass of 


787 * {@link SerialDate}. 

788 T 

789 * (Dparam day the day (1-31). 

790 * @param month the month (1-12). 

791 * @param yyyy the year (inthe range 1900to 9999). 

792 x 

793 * @return An instance of {@link SerialDate}. 

794 m 

795 public static SerialDate createInstance(final int day, final 
int month, 

796 
final int yyyy) { 

797 return new SpreadsheetDate(day, month, yyyy); 

798 j 

799 


800 [t 


801 


* Factory method that returns an instance of some 


concrete subclass of 


802 * {@link SerialDate}. 

803 x 

804 * @param serial the serial number for the day (1 
January 1900= 2). 

805 d 

806 * @returna instance of SerialDate. 

807 "i 

808 public static SerialDate createInstance(final int serial) { 

809 return new SpreadsheetDate(serial); 

810 } 

811 

812 prm 

813 * Factory method that returns an instance of a 
subclass of SerialDate. 

814 " 

815 * @param date A Java date object. 

816 * 

817 * @returna instance of SerialDate. 

818 dii 

819 public static SerialDate createInstance(final java.util.Date 
date) 1 

820 

821 final  GregorianCalendar calendar = new 
GregorianCalendar(); 

822 calendar.setTime(date); 


823 return new 
SpreadsheetDate(calendar.get(Calendar.DATE), 


824 
calendar.get(Calendar.MONTH) + 1, 

825 
calendar.get(Calendar. YEAR)); 

826 

827 } 

828 

829 prm 

830 * Returns the serial number for the date, where 1 January 
1900 = 2 (this 

831 * corresponds, almost, to the numbering system used in 


Microsoft Excel for 


832 * Windows and Lotus 1-2-3). 

833 x 

834 * @return the serial number for the date. 

835 gi 

836 public abstract int  toSerial(); 

837 

838 pm 

839 * Returns a java.util.Date. Since java.util.Date has more 


precision than 


840 * SerialDate, we need to define a convention for the 
time of day'. 
841 * 


842 * @return this as <code>java.util. Date</code>. 


843 */ 


844 public abstract java.util.Date toDate(); 

845 

846 [ee 

847 * Returns a_ description of the date. 

848 * 

849 * @returna description of the date. 

850 */ 

851 public String getDescription() { 

852 return this.description; 

853 } 

854 

855 pps 

856 * Sets the description for the date. 

857 d 

858 * @param description the new description for the date. 
859 wh 

860 public void setDescription(final String description) { 
861 this.description = description; 

862 } 

863 

864 prm 

865 * Converts the date to a string. 

866 * 

867 * @return a string representation of the date. 
868 "m 


869 public String toString() { 


870 return getDayOfMonth() + di 二 
SerialDate.monthCodeToString(getMonth()) 


871 ps eme ca 
getY YYY(); 

872 } 

873 

874 pps 

875 * Returns the year (assume a valid range of 1900 to 
9999). 

876 m 

877 * @return the year. 

878 di 

879 public abstract int getY YYY(); 

880 

881 p 

882 * Returns the month (January = 1, February = 2, March 
= 3). 

883 m 

884 * @return the month of the year. 

885 m 

886 public abstract int getMonth(); 

887 

888 PER 

889 * Returns the day of the month. 

890 x 

891 * @return the day of the month. 


892 ui 


893 
894 
895 
896 
897 
898 
899 
900 
901 
902 
903 
the specified 
904 
905 
906 
date and 
907 
908 
909 
910 
911 
912 
913 
914 
915 
916 


as the 


public abstract int getDayOfMonth(); 


/ 米 米 


* Returns the day of the week. 


* 


* @return the day of the week. 
3 
public abstract int getDayOfWeek(); 


[PE 


* Returns the difference (in days) between this date and 


* 'other' date. 
* <P> 


* The result is positive if this date is after the 'other' 


* negative if it is before the 'other' date. 


* 


* @param other the date being compared to. 


* 
* @return the difference between this and the other date. 
"mi 


public abstract int compare(SerialDate other); 


/ 米 米 


* Returns true if this SerialDate represents the same date 


917 
918 
919 
920 
921 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


the same date as 


922 
923 
924 
925 
926 
927 
compared to 
928 
929 
930 
931 
932 
an earlier date 
933 
934 
935 
936 
937 
938 
as the 
939 


the specified SerialDate. 
*/ 


public abstract boolean isOn(SerialDate other); 


[** 


* Returns true if this SerialDate represents an earlier date 


* the specified SerialDate. 


* 


* @param other The date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


i compared to the specified SerialDate. 
2 


public abstract boolean isBefore(SerialDate other); 


[E 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


940 
941 
942 
943 


* 


* @param other the date being compared to. 


* 


* @return <code>true<code> if this SerialDate 


represents the same date 


944 
945 
946 
947 
948 
949 
as the 
950 
951 
952 
953 
954 
the same date 
955 
956 
957 
958 
959 
960 
as the 
961 
962 


* as the specified SerialDate. 
3 


public abstract boolean isOnOrBefore(SerialDate other); 


[E 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


* as the specified SerialDate. 
zi 
public abstract boolean isAfter(SerialDate other); 


[E 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


* 


963 

964 

965 
the same date 

966 

967 

968 

969 

970 

971 
within the 

972 
and d2 is not 

973 

974 

975 

976 
range. 

977 

978 

979 

980 
SerialDate d2); 

981 

982 

983 


within the 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


i as the specified SerialDate. 
mi 
public abstract boolean isOnOrAfter(SerialDate other); 


[E 


* Returns <code>true</code> if this {@link SerialDate} is 


* specified range (INCLUSIVE). The date order of d1 


* important. 


* 


* @param dl a boundary date for the range. 
* @param d2 the other boundary date for the 


* 


* @retum A boolean. 
*/ 
public abstract boolean isInRange(SerialDate d1, 


[** 


* Returns <code>true</code> if this {@link SerialDate} is 


984 * specified range (caller specifies whether or not the 


end-points are 


985 * included). The date order of dl and d2 is not 
important. 

986 i 

987 * @param dl aboundary date for the range. 

988 * @param d2 the other boundary date for the 
range. 

989 * @param include a code that controls whether or not 


the start and end 


990 * dates are included in the 
range. 

991 ti 

992 * @return A boolean. 

993 si 

994 public abstract boolean  isInRange(SerialDate d1, 
SerialDate d2, 

995 
int include); 

996 

997 pm 

998 * Returns the latest date that falls onthe specified day- 
of-the-week and 

999 *is BEFORE this date. 

1000 x 

1001 * @param targetDOW a code for the target day-of- 


the-week. 


1002 
1003 


of-the-week and 


1004 
1005 
1006 


targetDOW) { 


1007 
1008 
1009 
1010 
1011 


day-of-the-week 


1012 
1013 
1014 
the-week. 
1015 
1016 


day-of-the-week 


1017 
1018 
1019 


targetDOW) { 


1020 
1021 
1022 


* 


* @return the latest date that falls on the specified day- 


ms is BEFORE this date. 
*/ 
public SerialDate — getPreviousDayOfWeek(final int 


return getPreviousDayOfWeek(targetDOW, this); 


/ 米 米 


* Returns the earliest date that falls on the specified 


* and is AFTER this date. 


* 


* @param targetDOW a code for the target day-of- 


* 


* @return the earliest date that falls on the specified 


m and is AFTER this date. 
di 
public SerialDate — getFollowingDayOfWeek(final int 


return getFollowingDayOfWeek(targetDOW, this); 
} 


1023 jee 


1024 * Returns the nearest date that falls on the specified d 
ay-of-the-week. 

1025 T 

1026 * @param targetDOW a code for the target day-of- 
the-week. 

1027 m 

1028 * (greturn the nearest date that falls on the specified 
day-of-the-week. 

1029 n 

1030 public SerialDate getNearestDayOfWeek(final int 
targetDOW) 1 

1031 return getNearestDayOfWeek(targetDOW, this); 

1032 } 

1033 

1034 } 

代码 清单 B-2 SerialDateTest.java 

1 P 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 
6 * 


7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or modi 
fy it 

10 * under the terms of the GNU Lesser General Public 
License as published by 

11 * the Free Software Foundation; either version 2.1 of the License, 
Or 

12 *(at your option) any later version. 

13 * 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY 

16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
Lesser General Public 

17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser 
General Public 

20 * License along with this library; if not, write to the Free 
Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, 

22 *USA. 

go 

24 * [Java is a trademark or registered trademark of Sun 


Microsystems, Inc. 


25 * in the United States and other countries.] 

26 * 

VAR pioli 

28 * SerialDateTests.java 

IG a eee is ai 

30 *(C) Copyright 2001-2005, by Object Refinery Limited. 

31 C 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 

34 ^ 

35 * $Id: SerialDateTests.java,v 1.6 2005/11/16 15:58:40 taqua 
Exp $ 

36 * 

37 * Changes 

Br dE uoc 

39 * 15-Nov-2001 : Version 1 (DG); 

40 * 25-Jun-2002 : Removed unnecessary import (DG); 

41 * 24-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

42 * 13-Mar-2003 : Added serialization test (DG); 

43 * 05-Jan-2005 : Added test for bug report 1096282 (DG); 

44 ^ 

45 */ 

46 

47 package org.jfree.date.junit; 

48 

49 import java.io.ByteArrayInputStream; 

50 import java.io.ByteArrayOutputStream; 


51 import java.io.ObjectInput; 

52 import java.io.ObjectInputStream; 

53 import java.io.ObjectOutput; 

54 import java.io.ObjectOutputStream; 
55 

56 import junit.framework.Test; 

57 import junit.framework.TestCase; 

58 import junit.framework.TestSuite; 

59 

60 import org.jfree.date.MonthConstants; 


61 import org.jfree.date.SerialDate; 


62 

63 /** 

64 *SomeJUnit tests for the ( (link SerialDate} 
65 */ 

66 public class SerialDateTests extends TestCase 1 
67 

68 /** Date representing November 9. */ 
69 private SerialDate nov9Y2001; 

70 

71 IR 

72 * Creates a new test case. 

73 = 

74 * @param name the name. 

75 i 

76 public SerialDateTests(final String name) 1 


77 super(name); 


class. 


78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 


94 
95 
96 
97 
98 
99 
100 


/ 米 米 

* Returns a test suite forthe JUnit test runner. 
* 

* @retum The test suite. 

x 

public static Test suite() 1 


return new TestSuite(SerialDateTests.class); 


pee 
* Problem set up. 

*/ 

protected void setUp() { 


thisnov9Y2001 = SerialDate.createInstance(9, 
MonthConstants. NOVEMBER, 2001); 


} 


/ 米 米 


* 9 Nov 2001 plus two. months should be 9Jan 2002. 


iù 
public void testAddMonthsTo9Nov2001() { 


final SerialDate jan9Y 2002 


SerialDate.addMonths(2, this.nov9Y2001); 


101 


final SerialDate answer 


SerialDate.createInstance(9, 1, 2002); 


102 
103 
104 
105 
106 
107 
108 
109 


assertEquals(answer, jan9Y 2002); 


Li 
* A test case fora reported bug, now fixed. 
mi 

public void testAddMonthsTo50ct2003() 1 


final SerialDate d1 - SerialDate.createInstance(5, 


MonthConstants.OCTOBER, 2003); 


110 
111 


final SerialDate d2 =  SerialDate.addMonths(2, d1); 


assertEquals(d2, SerialDate.createInstance(5, 


MonthConstants.DECEMBER, 2003)); 


112 
113 
114 
115 
116 
117 
118 


} 


[ee 
* A test case fora reported bug, now fixed. 
wh 

public void testAddMonthsTo1Jan2003() 1 


final SerialDate d1 = SerialDate.createInstance(1, 


MonthConstants.JANUARY, 2003); 


119 
120 
121 
122 
123 
124 


5 November. 


final SerialDate d2 =  SerialDate.addMonths(0, d1); 
assertEquals(d2, d1); 


[** 


* Monday preceding Friday 9 November 2001 should be 


125 ui 


126 public void testMondayPrecedingFriday9Nov2001() { 

127 SerialDate mondayBefore = 
SerialDate.getPreviousDayOfWeek( 

128 SerialDate MONDAY, this.nov9Y2001 

129 y 

130 assertEquals(5, mondayBefore.getDayOfMonth()); 

131 } 

192 

133 JA 

134 * Monday following Friday 9 November 2001 should be 
12 November. 

135 2 

136 public void | testMondayFollowingFriday9Nov2001() 1 

137 SerialDate mondayAfter = 
SerialDate.getFollowingDayOfWeek( 

138 SerialDate.MONDA Y, this.nov9Y2001 

139 ); 

140 assertEquals(12, mondayAfter.getDayOfMonth()); 

141 } 

142 

143 ye 

144 * Monday nearest Friday 9 November 2001 should be 12 
November. 

145 = 

146 public void  testMondayNearestFriday9Nov2001() { 


147 SerialDate mondayNearest = 


SerialDate.getNearestDayOfWeek( 


148 
149 
150 
151 
152 
153 
154 
the 19th. 
155 
156 
157 


158 


SerialDate MONDAY, this.nov9Y2001 
); 
assertEquals(12, mondayNearest.getDayOfMonth()); 


/ 米 米 


* The Monday nearest to 22nd January 1970 falls on 


i 
public void testMondayNearest22Jan1970() 1 
SerialDate jan22Y 1970 = SerialDate.createInstance 
(22, MonthConstants.JANUARY, 1970); 
SerialDate 


mondayNearest-SerialDate.getNearestDayOfWeek 


159 
160 
161 
162 
163 


returns 


164 


modified. 


165 
166 


(SerialDate. MONDAY,  jan22Y1970); 
assertEquals(19, mondayNearest.getDayOfMonth()); 


[E 


* Problem that the conversion of days to strings 


the right result. 


* Actually, this 


* result depends on the Locale so this test needs to be 


*/ 
public void testWeekdayCodeToString() { 


167 


168 final String test = 
SerialDate.weekdayCodeToString(SerialDate.SATURDAY); 

169 assertEquals("Saturday", test); 

170 

171 } 

172 

173 [AR 

174 * Test the conversion of a string to a weekday. Note 


that this test will 


fail if the 

175 * default locale doesn't use English weekday 
names...devise a better test! 

176 T 

177 public void  testStringl'oWeekday() 1 

178 

179 int weekday = 
SerialDate.stringToWeekdayCode("Wednesday"); 

180 assertEquals(SerialDate. WEDNESDAY, weekday); 

181 

182 weekday =  SerialDate.stringl'oWeekdayCode(" 
Wednesday "); 

183 assertEquals(SerialDate. WEDNESDAY, weekday); 

184 

185 weekday = SerialDate.stringl'oWeekdayCode(" Wed"); 

186 assertEquals(SerialDate. WEDNESDAY, weekday); 


187 


189 
190 EE 
191 * Test the conversion of a string to a month. Note that 


this test will 
fail if the 
192 * default locale doesn't use English month 


names...devise a better test! 


193 e 

194 public void testStringToMonthCode() 1 

195 

196 int m = SerialDate.stringll'oMonthCode( January"); 
197 assertEquals(MonthConstants.JANUARY, m); 

198 

199 m = SerialDate.stringToMonthCode(" January "); 
200 assertEquals(MonthConstants.JANUARY, m); 

201 

202 m = SerialDate.stringl'oMonthCode(" Jan"); 

203 assertEquals(MonthConstants.JANUARY, m); 

204 

205 j 

206 

207 prs 

208 * Tests the conversion of a month code toa string. 
209 dii 

210 public void testMonthCodeToStringCode() { 


211 


212 


final String test = 


SerialDate.monthCodeToString(MonthConstants. DECEMBER); 


213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
including 
233 
234 
235 
236 


assertEquals("December", test); 


Li 

* 1900 is not a leap year. 

SI 

public void testIsNotLeapYear1900() { 
assert True(!SerialDate.isLeap Y ear(1900)); 


Li 

* 2000 isa leap year. 

*/ 

public void testIsLeapYear20000 1 
assertTrue(SerialDate.isLeapYear(2000)); 


LI 
* The number of leap years from 1900  up-to-and- 
1899 is 0. 
"mi 
public void testLeapYearCount1899() 1| 
assertEquals(SerialDate.leap Y earCount(1899), 0); 


237 


238 prm 

239 * The number of leap years from 1900  up-to-and- 
including 1903is 0. 

240 "i 

241 public void testLeapYearCount1903() 1 

242 assertEquals(SerialDate.leap Y earCount(1903), 0); 

243 } 

244 

245 pm 

246 * The number of leap years from 1900  up-to-and- 
including 1904is 1. 

247 i 

248 public void testLeapYearCount1904() { 

249 assertEquals(SerialDate.leap YearCount(1904), 1); 

250 } 

251 

252 [am 

253 * The number of leap years from 1900 up-to-and- 
including 1999 is 24. 

254 eh 

255 public void testLeapYearCount1999() { 

256 assertEquals(SerialDate.leap Y earCount(1999), 24); 

257 } 

258 

259 prm 


260 * The number of leap years from 1900  up-to-and- 


including 2000is 25. 

261 "m 

262 public void testLeapYearCount2000() 1 

263 assertEquals(SerialDate.leap Y earCount(2000), 25); 

264 } 

265 

266 (RE 

267 * Serialize an instance, restore it, and check for 
equality. 

268 di 

269 public void  testSerialization() { 

270 

271 SerialDate dl =  SerialDate.createInstance(15, 4, 
2000); 

272 SerialDate d2 = null; 

273 

274 try { 

275 ByteArrayOutputStream buffer = new 
ByteArrayOutputStream(); 

276 ObjectOutput out = new 
ObjectOutputStream(buffer); 

277 out. writeObject(d1); 

278 out.close(); 

279 

280 ObjectInput in= new ObjectInputStream 

(new 


ByteArrayInputStream(buffer.tol 


281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
2004); 
296 
297 
2, 2005); 
298 
299 
300 
301 
302 
303 
304 
305 


d2 = (SerialDate) in.readObject(); 
in.close(); 


} 
catch (Exception e) { 
System.out.println(e.toString()); 


j 
assertEquals(d1, d2); 


/ 米 米 

* A test for bug report 1096282 (now fixed). 
SI 

public void test1096282() 1 


SerialDate d =  SerialDate.createInstance(29, 2, 


d = SerialDate.addY ears(1, d); 


SerialDate expected = SerialDate.createInstance(28, 


assertTrue(d.isOn(expected)); 


[E 

* Miscellaneous tests for the addMonths() method. 
£4 

public void testAddMonths() 1 


SerialDate dl =  SerialDate.createInstance(31, 5, 


2004); 


306 

307 SerialDate d2 =  SerialDate.addMonths(1, d1); 

308 assertEquals(30, d2.getDayOfMonth()); 

309 assertEquals(6, d2.getMonth()); 

310 assertEquals(2004, d2.getY Y Y Y()); 

311 

312 SerialDate d3 =  SerialDate.addMonths(2, d1); 

313 assertEquals(31, d3.getDayOfMonth()); 

314 assertEquals(7, | d3.getMonth()); 

315 assertEquals(2004, d3.getY Y Y Y ()); 

316 

317 SerialDate d4 = SerialDate.addMonths(1, 
SerialDate.addMonths(1, d1)); 

318 assertEquals(30, d4.getDayOfMonth()); 

319 assertEquals(7, d4.getMonth()); 

320 assertEquals(2004, | d4.getY YYY()); 

321 } 

322 } 

代码 清单 B-3 MonthConstants.java 

1 /* 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or modi 
fy it 

10 * under the terms of the GNU Lesser General Public 
License as published by 

11 * the Free Software Foundation; either version 2.1 of the License, 
Or 

12 *(at your option) any later version. 

T9 学 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY 

16 * or FITNESS. FOR A PARTICULAR PURPOSE. See the GNU 
Lesser General Public 

17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser 
General Public 

20 * License along with this library; if not, write to the Free 
Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, 

22 *USA. 


23 


* 


24 * [Java is a trademark or registered trademark of Sun 
Microsystems, Inc. 

25 *inthe United States and other countries.] 

26 * 

DR 

28 * MonthConstants.java 

DO. her ot eae 

30 * (C) Copyright 2002, 2003, by Object Refinery Limited. 

31 * 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 

34 * 

35 * $Id: MonthConstants.java,v 1.4 2005/11/16 15:58:40 taqua Exp 
$ 

36 * 

37 * Changes 

Bo. Ue: lillo 

39 * 29-May-2002 : Version 1 (code moved from SerialDate class) 
(DG); 

40 * 

41 */ 

42 

43 package org.jfree.date; 

44 

45 /** 


46 


* Useful constants for months. Note that these are NOT 


equivalent to the 

47 * constants defined by java.util.Calendar (where 
JANUARY=0 and DECEMBER=11). 

48 * <P> 

49 * Used by the SerialDate and RegularTimePeriod classes. 

50 * 

51 * @author David Gilbert 


52 */ 

53 public interface MonthConstants { 

54 

55 /** Constant for January. */ 

56 public static final int JANUARY = 1; 
57 

58 /** Constant for February. */ 

59 public static final int FEBRUARY = 2; 
60 

61 /** Constant for March. */ 

62 public static final int MARCH = 3; 
63 

64 /** Constant for April. */ 

65 public static final int APRIL = 4; 
66 

67 /** Constant for May. */ 

68 public static final int MAY = 5; 

69 

70 /** Constant for June. */ 


71 public static final int JUNE = 6; 


72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91} 


/** Constant 


public static 


/** Constant 


public static 


/** Constant 


public static 


/** Constant 


public static 


/** Constant 


public static 


/** Constant 


public static 


for July. */ 
final int JULY = 7; 


for August. */ 
finalint AUGUST =8; 


for September. */ 
final int SEPTEMBER = 9; 


for October. */ 
final int OCTOBER = 10; 


for November. */ 
final int NOVEMBER = 11; 


for December. */ 
final int DECEMBER = 12; 


代码 清单 B-4 BobsSerialDateTest.java 


1 package org.jfree.date.junit; 


2 


3 import junit.framework.TestCase; 


4 import org.jfree.date.*; 


5 import static org.jfree.date.SerialDate.*; 


6 


7 import java.util.*; 


8 

9 public class BobsSerialDateTest extends TestCase { 

10 

11 public void testIsValidWeekdayCode() throws Exception { 

12 for (int day =1;day <= 7; day++) 

13 assert True(isValidWeekdayCode(day)); 

14 assertFalse(is ValidWeekdayCode(0)); 

15 assertFalse(is ValidWeekdayCode(8)); 

16 } 

17 

18 public void testStringToWeekdayCode() throws Exception 
{ 

19 

20 assertEquals(-1, stringToWeekdayCode("Hello")); 

21 assertEquals(MONDA Y, stringToWeekdayCode("Monday")); 

22 assertEquals(MONDAY,  stringl'oWeekdayCode("Mon")); 

23 //todo 
assertEquals(MONDA Y string ToWeekdayCode("monday")); 

24 // 
assertEquals(MONDA Y stringToWeekdayCode("MONDAY")); 

25 // assertEquals(MONDAY, stringToWeekdayCode("mon")); 

26 

27 assertEquals(TUESDAY, 
stringToWeekdayCode("Tuesday")); 

28 assertEquals(TUESDAY, string ToWeekdayCode(""Tue")); 

29 // assertEquals( TUESDAY string ToWeekdayCode("tuesday")); 


30 // 
assertEquals( TUESDAY stringToWeekdayCode("TUESDAY")); 

31 // assertEquals( TUESDAY,  stringl'oWeekdayCode(" tue")); 

32 // assertEquals( TUESDAY, string l'oWeekdayCode( tues")); 

33 


34 assertEquals (WEDNESDAY, 
stringToWeekdayCode("Wednesday")); 

35 assertEquals(WEDNESDAY, 
stringToWeekdayCode("Wed")); 

36 // 
assertEquals(WEDNESDAY,stringToWeekdayCode("wednesday")); 

37 // 
assertEquals(WEDNESDAY, string ToWeekdayCode("WEDNESDAY")); 

38 // assertEquals(WEDNESDAY, 
stringToWeekdayCode("wed")); 

39 

40 assertEquals(THURSDAY, 
stringToWeekdayCode("Thursday")); 

41 assertEquals(THURSDAY,  stringl'oWeekdayCode("Thu")); 

42 // 
assertEquals( THURSDAY , string ToWeekdayCode("thursday")); 

43 Il 


assertEquals(THURSDAY stringToWeekdayCode("THURSDAY")); 
44 // assertEquals( THURSDAY, stringToWeekdayCode("thu")); 
45 // assertEquals( THURSDAY, string l'oWeekdayCode( thurs")); 
46 
47 assertEquals(FRIDAY, stringToWeekdayCode("Friday")); 


48 assertEquals(FRIDAY, stringToWeekdayCode("Fri")); 

49 // assertEquals(FRIDAY, string ToWeekdayCode("friday")); 

50 // assertEquals(FRIDAY, string ToWeekdayCode("FRIDAY")); 
51 // assertEquals(FRIDAY, stringToWeekdayCode("fri")); 


52 

53 assertEquals(SATURDAY, 
stringToWeekdayCode("Saturday")); 

54 assertEquals(sATURDAY,  stringl'oWeekdayCode("Sat")); 

55 // 
assertEquals(SATURDAY string ToWeekdayCode("saturday")); 

56 // 


assertEquals(SATURDAY, string ToWeekdayCode("SATURDAY")); 
57 // assertEquals(SATURDAY, string ToWeekdayCode("sat")); 


58 

59 assertEquals(SUNDAY, string ToWeekdayCode("Sunday")); 
60 assertEquals(SUNDAY, string ToWeekdayCode("Sun")); 

61 // assertEquals(SUNDAY, string ToWeekdayCode("sunday")); 
62 // 


assertEquals(SUNDAY stringl'oWeekdayCode( SUNDAY ")); 
63 // assertEquals(SUNDAY, stringToWeekdayCode("sun")); 


64 } 

65 

66 public void testWeekdayCodeToString() throws Exception 
{ 

67 assertEquals("Sunday", weekdayCodeToString(SUNDAY)); 

68 assertEquals("Monday", 


weekdayCodeToString(MONDA Y)); 


69 assertEquals("Tuesday", weekdayCodeToString(TUESDAY)); 


70 assertEquals("Wednesday", 
weekdayCodeToString(WEDNESDAY)); 

71 assertEquals("Thursday", 
weekdayCodeToString(THURSDAY)); 

72 assertEquals("Friday", weekdayCodeToString(FRIDAY)); 

73 assertEquals("Saturday", 
weekdayCodeToString(SATURDAY)); 

74 } 

75 

76 public void testIsValidMonthCode() throws Exception { 

77 for (inti= 1;i<=12;i++) 

78 assert True(is ValidMonthCode(i)); 

79 assertFalse(is ValidMonthCode(0)); 

80 assertFalse(is ValidMonthCode(13)); 

81 } 

82 

83 public void testMonthToQuarter() throws Exception { 

84 assertEquals(1, monthCodeToQuarter(JANUARY)); 

85 assertEquals(1, monthCodeToQuarter(FEBRUARY)); 

86 assertEquals(1, monthCodeToQuarter(MARCH)); 

87 assertEquals(2, monthCodeToQuarter(APRIL)); 

88 assertEquals(2, monthCodeToQuarter(MAY)); 

89 assertEquals(2, monthCodeToQuarter(JUNE)); 

90 assertEquals(3, monthCodeToQuarter(JULY)); 

91 assertEquals(3, monthCodeToQuarter(AUGUST)); 


92 assertEquals(3, monthCodeToQuarter(SEPTEMBER)); 


93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 


assertEquals(4, monthCodeToQuarter(OCTOBER)); 
assertEquals(4, monthCodeToQuarter(NOVEMBER)); 
assertEquals(4, monthCodeToQuarter(DECEMBER)); 


try { 
monthCodeToQuarter(-1); 
fail("Invalid Month Code should throw exception"); 
} catch (IllegalArgumentException e) { 
} 


public void testMonthCodeToString() throws Exception { 
assertEquals("January", monthCodeToString(JANUARY)); 


assertEquals("February", 


monthCodeToString(FEBRUARY)); 


107 
108 
109 
110 
111 
112 
113 


assertEquals("March", monthCodeToString(MARCH)); 
assertEquals("April", monthCodeToString( APRIL)); 
assertEquals(" May", monthCodeToString( MAY )); 
assertEquals("June", monthCodeToString(JUNE)); 
assertEquals("July", monthCodeToString(JULY)); 
assertEquals("August", monthCodeToString(AUGUST)); 


assertEquals("September", 


monthCodeToString(SEPTEMBER)); 


114 
115 


assertEquals("October", monthCodeToString(OCTOBER)); 


assertEquals("November", 


monthCodeToString(NOVEMBER)); 


116 


assertEquals("December", 


monthCodeToString(DECEMBER)); 


117 
118 
119 
true)); 
120 
121 
122 
123 
124 
125 
126 
true)); 
127 
128 
true)); 
129 
true)); 
130 
131 
132 
133 
134 
135 
136 
137 
138 


assertEquals("Jan", monthCodeToString(JANUARY, true)); 
assertEquals("Feb", | monthCodeToString(FEBRUARY, 


assertEquals("Mar", monthCodeToString(MARCH,  true)); 
assertEquals(" Apr", monthCodeToString(APRIL, true)); 
assertEquals(" May", monthCodeToString(MA Y, true)); 
assertEquals("Jun", monthCodeToString(JUNE, true)); 
assertEquals("Jul", monthCodeToString(JULY,  true)); 
assertEquals(" Aug", monthCodeToString( AUGUST, true)); 
assertEquals("Sep", monthCodeToString( SEPTEMBER, 


assertEquals("Oct", monthCodeToString(OCTOBER, true)); 
assertEquals("Nov", monthCodeToString(NOVEMBER, 


assertEquals("Dec", monthCodeToString(DECEMBER, 


try { 
monthCodeToString(-1); 
fail("Invalid month code should throw exception"); 


} catch (IllegalArgumentException e) { 
j 


139 public void testStringl'oMonthCode() throws Exception { 


140 assertEquals(JANUA RY string l'oMonthCode(" 1")); 
141 assertEquals(FEBRUARY,stringl'oMonthCode("2")); 
142 assertEquals(:MARCH,stringl'oMonthCode("3")); 

143 assertEquals(APRIL,stringToMonthCode("4")); 

144 assertEquals(MAY string ToMonthCode("5")); 

145 assertEquals(JUNE, string ToMonthCode('"6")); 

146 assertEquals(JULY,stringToMonthCode("7")); 

147 assertEquals(AUGUST,stringToMonthCode("8")); 

148 assertEquals(SEPTEMBER, stringToMonthCode("9")); 
149 assertEquals(OCTOBER, stringToMonthCode("10")); 
150 assertEquals(NOVEMBER, stringToMonthCode("11")); 
151 assertEquals(DECEMBER, stringToMonthCode("12")); 
152 


153 //todo assertEquals(-1, stringToMonthCode("0")); 
154 // assertEquals(-1, stringToMonthCode("13")); 


155 

156 assertEquals(-1,stringToMonthCode("Hello")); 

157 

158 for (intim= 1;m<= 12; m++){ 

159 assertEquals(m, 
stringToMonthCode(monthCodeToString(m,  false))); 

160 assertEquals(m, 
stringToMonthCode(monthCodeToString(m, true))); 

161 } 

162 


163 // assertEquals(1,stringToMonthCode("jan")); 


164 // assertEquals(2,stringToMonthCode("feb")); 
165 // assertEquals(3,stringToMonthCode("mar")); 
166 // assertEquals(4,stringToMonthCode("apr")); 
167 // assertEquals(5,stringToMonthCode("may")); 
168 // assertEquals(6,stringToMonthCode("jun")); 
169 // assertEquals(7,stringToMonthCode("jul")); 
170 // assertEquals(8,stringToMonthCode("aug")); 
171 // assertEquals(9,stringToMonthCode("sep")); 
172 // assertEquals(10,stringToMonthCode("oct")); 
173 // assertEquals(11,stringToMonthCode("nov")); 
174 // assertEquals(12,string ToMonthCode("dec")); 
175 

176 // assertEquals(1,string ToMonthCode("JAN")); 
177 // assertEquals(2,stringToMonthCode("FEB")); 
178 // assertEquals(3,stringToMonthCode("MAR")); 
179 // assertEquals(4,stringToMonthCode("APR")); 
180 // assertEquals(5,stringToMonthCode("MAY")); 
181 // assertEquals(6,stringToMonthCode("JUN")); 
182 // assertEquals(7,stringToMonthCode("JUL")); 
183 // assertEquals(8,stringToMonthCode("AUG")); 
184 // assertEquals(9,stringToMonthCode("SEP")); 
185 // assertEquals(10,stringToMonthCode("OCT")); 
186 // assertEquals(11,stringToMonthCode("NOV")); 
187 // assertEquals(12,stringToMonthCode("DEC")); 
188 

189 // assertEquals(1,stringToMonthCode("january")); 
190 // assertEquals(2,stringToMonthCode("february")); 


191 // assertEquals(3,stringToMonthCode("march")); 

192 // assertEquals(4,stringToMonthCode("april")); 

193 // assertEquals(5,stringToMonthCode("may")); 

194 // assertEquals(6,stringToMonthCode("june")); 

195 // assertEquals(7,string ToMonthCode("july")); 

196 // assertEquals(8,string ToMonthCode("august")); 

197 // assertEquals(9,stringToMonthCode("september")); 
198 // assertEquals(10,stringToMonthCode("october")); 
199 // assertEquals(11,stringToMonthCode("november")); 
200 // assertEquals(12,stringToMonthCode("december")); 


202 // assertEquals(1,stringl'oMonthCode(" JANUARY ")); 
203 // assertEquals(2,stringToMonthCode("FEBRUARY")); 
204 // assertEquals(3,stringToMonthCode("MAR")); 

205 // assertEquals(4,stringToMonthCode("APRIL")); 

206 // assertEquals(5,stringToMonthCode("MAY")); 

207 // assertEquals(6,string ToMonthCode("JUNE")); 

208 // assertEquals(7,stringToMonthCode("JULY")); 

209 // assertEquals(8,stringToMonthCode("AUGUST")); 

210 // assertEquals(9,stringToMonthCode("SEPTEMBER")); 
211 // assertEquals(10,stringToMonthCode("OCTOBER")); 
212 // assertEquals(11,stringToMonthCode("NOVEMBER")); 
213 // assertEquals(12,stringToMonthCode("DECEMBER")); 


216 public void testIsValidWeekInMonthCode() throws 


Exception 1 


217 
218 
219 
220 
221 
222 
225 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 


for (intw= 0;w«- 4;wtt) { 
assertTrue(isValidWeekInMonthCode(w)); 


j 
assertFalse(isValidWeekInMonthCode(5)); 


public void testIsLeapYear() throws Exception { 
assertFalse(isLeapYear(1900)); 
assertFalse(isLeapYear(1901)); 
assertFalse(isLeapYear(1902)); 
assertFalse(isLeapYear(1903)); 
assertTrue(isLeapYear(1904)); 
assert True(isLeap Y ear(1908)); 
assertFalse(isLeapYear(1955)); 
assert True(isLeap Y ear(1964)); 
assert True(isLeap Y ear(1980)); 
assert True(isLeap Y ear(2000)); 
assertFalse(isLeapYear(2001)); 
assertFalse(isLeapYear(2100)); 


public void testLeapYearCount() throws Exception { 
assertEquals(0, leapYearCount(1900)); 
assertEquals(0, leapYearCount(1901)); 
assertEquals(0, leapYearCount(1902)); 
assertEquals(0, leapYearCount(1903)); 
assertEquals(1, leapYearCount(1904)); 


244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 


assertEquals(1, leapYearCount(1905)); 
assertEquals(1, leapYearCount(1906)); 
assertEquals(1, leapYearCount(1907)); 
assertEquals(2, leapYearCount(1908)); 
assertEquals(24, leapYearCount(1999)); 
assertEquals(25, leapYearCount(2001)); 
assertEquals(49, leapYearCount(2101)); 
assertEquals(73, leapYearCount(2201)); 
assertEquals(97, leapYearCount(2301)); 
assertEquals(122, leapYearCount(2401)); 


public void  testLastDayOfMonth() throws Exception { 
assertEquals(31, lastDayOfMonth(JANUARY, 1901)); 
assertEquals(28, lastDayOfMonth(FEBRUARY, 1901)); 
assertEquals(31, lastDayOfMonth(MARCH, 1901); 
assertEquals(30, lastDayOfMonth(APRIL, 1901)); 
assertEquals(31, lastDayOfMonth(MAY, 1901); 
assertEquals(30, lastDayOfMonth(JUNE, 1901)); 
assertEquals(31, lastDayOfMonth(JULY, 1901); 
assertEquals(31, lastDayOfMonth(AUGUST, 1901)); 
assertEquals(30, lastDayOfMonth(SEPTEMBER, 1901)); 
assertEquals(31, lastDayOfMonth(OCTOBER, 1901)); 
assertEquals(30, lastDayOfMonth(NOVEMBER, 1901)); 
assertEquals(31, lastDayOfMonth(DECEMBER, 1901)); 
assertEquals(29, lastDayOfMonth(FEBRUARY, 1904)); 


271 
272 public void  testAddDays() throws Exception 1 


273 SerialDate newYears = d(1, JANUARY, 1900); 

274 assertEquals(d(2, JANUARY, 1900) addDays(1, 
new Y ears)); 

275 assertEquals(d(1, FEBRUARY, 1900), addDays(31, 
new Y ears)); 

276 assertEquals(d(1, JANUARY, 1901), addDays(365, 
new Y ears)); 

277 assertEquals(d(31, DECEMBER, 1904), addDays(5 * 
365, newY ears)); 

278 } 

279 


280 private static SpreadsheetDate d(int day, int month, int year) 
{return new 


SpreadsheetDate(day, month, year);} 


281 

282 public void testAddMonths() throws Exception { 

283 assertEquals(d(1, FEBRUARY, 1900), addMonths(1, d(1, 
JANUARY, 1900))); 

284 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, 
d(31, JANUARY, 1900))); 

285 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, 
d(30, JANUARY, 1900))); 

286 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, 


d(29, JA NUARY, 1900))); 
287 assertEquals(d(28, FEBRUARY, 1900), addMonths(1, 


d(28, JANUARY, 1900))); 


288 assertEquals(d(27, | FEBRUARY, 1900), addMonths(1, 
d(27, JANUARY, 1900))); 

289 

290 assertEquals(d(30, JUNE, 1900), addMonths(5, d(31, 
JANUARY, 1900))); 

291 assertEquals(d(30, JUNE, 1901), addMonths(17, d(31, 
JANUARY, 1900))); 

292 

293 assertEquals(d(29, FEBRUARY, 1904), addMonths(49, 
d(31, JANUARY, 1900))); 

294 

295 } 

296 

297 public void testAddYears() throws Exception { 

298 assertEquals(d(1, JANUARY, 1901), addYears(1, d(1, 
JANUARY, 1900))); 

299 assertEquals(d(28, FEBRUARY, 1905), addYears(1, 
d(29, FEBRUARY, 1904))); 

300 assertEquals(d(28, FEBRUARY, 1905), addYears(1, 
d(28, FEBRUARY, 1904))); 

301 assertEquals(d(28, FEBRUARY, 1904), addYears(1, 
d(28, FEBRUARY, 1903))); 

302 } 

303 


304 public void testGetPreviousDayOfWeek() throws Exception { 
305 assertEquals(d(24, FEBRUARY, 2006), 


getPreviousDayOfWeek(FRIDAY, 
d(1, MARCH, 2006))); 
306 assertEquals(d(22, FEBRUARY, 2006), 
getPreviousDayOfWeek(WEDNESDAY, 
d(1, MARCH, 2006))); 
307 assertEquals(d(29, FEBRUARY, 2004), 
getPreviousDayOfWeek(SUNDAY, 
d(3, MARCH, 2004))); 
308 assertEquals(d(29, DECEMBER, 2004), 
getPreviousDayOfWeek(WEDNESDAY, 
d(5, JANUARY, 2005))); 
309 
310 try { 
311 getPreviousDayOfWeek(-1, d(1, JANUARY, 2006)); 
312 fail("Invalid day of week code should throw 
exception"); 
313 } catch (IllegalArgumentException e) 1 
314 } 
315 } 
316 
317 public void testGetFollowingDayOfWeek() throws 
Exception 1 
318 // assertEquals(d(1, JANUARY, 
2005), getFollowingDayOfWeek(SATURDAY, 
d(25, DECEMBER, 2004))); 
319 assertEquals(d(1, JANUARY, 2005), getFollowin 
gDayOfWeek(SATURDAY, 


d(26, DECEMBER, 2004))); 


320 assertEquals(d(3, MARCH, 2004), 

getFollowingDayOfWeek(WEDNESDAY, 
d(28, FEBRUARY, 2004))); 

321 

322 try { 

323 getFollowingDayOfWeek(-1, d(1, JANUARY, 2006)); 

324 fail("Invalid day of week code should throw 
exception"); 

325 } catch (IllegalArgumentException e) 1 

326 } 

327 } 

328 

329 public void testGetNearestDayOfWeek() throws Exception 
{ 

330 assertEquals(d(16, APRIL, 2006), 
getNearestDayOfWeek(SUNDA Y, d(16, APRIL, 2006))); 

331 assertEquals(d(16, APRIL, 2006), 
getNearestDayOfWeek(SUNDA Y, d(17, APRIL, 2006))); 

332 assertEquals(d(16, APRIL, 2006), 
getNearestDayOfWeek(SUNDA Y, d(18, APRIL, 2006))); 

333 assertEquals(d(16, APRIL, 2006), 
getNearestDayOfWeek(SUNDA Y, d(19, APRIL, 2006))); 

334 assertEquals(d(23, APRIL, 2006), 
getNearestDayOfWeek(SUNDA Y, d(20, APRIL, 2006))); 

335 assertEquals(d(23, APRIL, 2006), 


getNearestDayOfWeek(SUNDA Y, d(21, APRIL, 2006))); 


336 assertEquals(d(23, APRIL, 2006), 
getNearestDayOfWeek(SUNDAY, d(22, APRIL, 2006))); 
337 
338 //todo assertEquals(d(17, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, 
d(16, APRIL, 2006))); 


339 assertEquals(d(17, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(17, APRIL, 2006))); 

340 assertEquals(d(17, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(18, APRIL, 2006))); 

341 assertEquals(d(17, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(19, APRIL, 2006))); 

342 assertEquals(d(17, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(20, APRIL, 2006))); 

343 assertEquals(d(24, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(21, APRIL, 2006))); 

344 assertEquals(d(24, APRIL, 2006), 
getNearestDayOfWeek(MONDAY, d(22, APRIL, 2006))); 

345 

346 // assertEquals(d(18, APRIL, 2006), 


getNearestDayOfWeek(TUESDAY, 
d(16, APRIL, 2006))); 
347 // assertEquals(d(18, APRIL, 2006), 
getNearestDayOfWeek(TUESDAY, 
d(17, APRIL, 2006))); 
348 
assertEquals(d(18, APRIL,2006),getNearestDayOfWeek(TUESDAY,d(18, AP] 


349 
assertEquals(d(18,APRIL,2006),getNearestDayOfWeek(TUESDAY,d(19,API 
350 
assertEquals(d(18,APRIL,2006),getNearestDayOfWeek(TUESDA Y,d(20,A PI 
351 
assertEquals(d(18, APRIL,2006),getNearestDayOfWeek( TUESDAY ,d(21,A PJ 
352 
assertEquals(d(25, APRIL,2006),getNearestDayOfWeek( TUESDAY ,d(22,A P] 
353 
354 // assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY 
d(16, APRIL, 2006))); 
355 // assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY, 
d(17, APRIL, 2006))); 
356 // assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY, 
d(18, APRIL, 2006))); 
357 assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY, 
d(19, APRIL, 2006))); 
358 assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY, 
d(20, APRIL, 2006))); 
359 assertEquals(d(19, APRIL, 2006), 
getNearestDayOfWeek(WEDNESDAY, 
d(21, APRIL, 2006))); 


360 assertEquals(d(19, APRIL, 


getNearestDayOfWeek(WEDNESDAY, 
d(22, APRIL, 2006))); 
361 
362 // assertEquals(d(13, 
getNearestDayOfWeek(THURSDAY, 
d(16, APRIL, 2006))); 
363 // assertEquals(d(20, 
getNearestDayOfWeek(THURSDAY, 
d(17, APRIL, 2006))); 
364 // assertEquals(d(20, 
getNearestDayOfWeek(THURSDAY, 
d(18, APRIL, 2006))); 
365 // assertEquals(d(20, 
getNearestDayOfWeek(THURSDAY, 
d(19, APRIL, 2006))); 


366 assertEquals(d(20, APRIL, 


getNearestDayOfWeek(THURSDAY, 
d(20, APRIL, 2006))); 


367 assertEquals(d(20, APRIL, 


getNearestDayOfWeek(THURSDAY, 
d(21, APRIL, 2006))); 


368 assertEquals(d(20, APRIL, 


getNearestDayOfWeek(THURSDAY, 
d(22, APRIL, 2006))); 
369 
370// 


APRIL, 


APRIL, 


APRIL, 


APRIL, 


2006), 


2006), 


2006), 


2006), 


2006), 


2006), 


2006), 


2006), 


assertEquals(d(14,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(16,APRI 
371// 
assertEquals(d(14,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(17,APRI 


372// 
assertEquals(d(21,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(18,APRI 

373// 
assertEquals(d(21,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(19,APRI 

374// 
assertEquals(d(21,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(20,APRI 

375 assertEquals(d(21, APRIL, 2006), 
getNearestDayOfWeek(FRIDA Y, d(21, APRIL, 2006))); 

376 assertEquals(d(21, APRIL, 2006), 
getNearestDayOfWeek(FRIDA Y, d(22, APRIL, 2 006))); 

377 

378 // assertEquals(d(15, APRIL, 2006), 


getNearestDayOfWeek(SATURDAY, 
d(16, APRIL, 2006))); 

379 // assertEquals(d(15, APRIL, 2006), 
getNearestDayOfWeek(SATURDAY, 
d(17, APRIL, 2006))); 

380 // assertEquals(d(15, APRIL, 2006), 
getNearestDayOfWeek(SATURDAY, 
d(18, APRIL, 2006))); 

381 // assertEquals(d(22, APRIL, 2006), 
getNearestDayOfWeek(SATURDAY, 
d(19, APRIL, 2006))); 

382 // assertEquals(d(22, APRIL, 2006), 


getNearestDayOfWeek(SA TURDAY, 
d(20, APRIL, 2006))); 
383 // assertEquals(d(22, APRIL, 2006), 
getNearestDayOfWeek(SATURDAY, 
d(21, APRIL, 2006))); 
384 assertEquals(d(22, APRIL, 2006), 
getNearestDayOfWeek(SATURDAY, 
d(22, APRIL, 2006))); 


385 

386 try { 

387 getNearestDayOfWeek(-1, d(1, JANUARY, 2006)); 

388 fail("Invalid day of week code should throw 
exception"); 

389 } catch (IllegalArgumentException e) 1 

390 } 

391 } 

392 

393 public void testEndOfCurrentMonth() throws Exception { 

394 SerialDate d = SerialDate.createInstance(2); 

395 assertEquals(d(31, JANUARY, 2006), 
d.getEndOfCurrentMonth(d(1, JANUARY, 2006))); 

396 assertEquals(d(28, FEBRUARY,2006), 
d.getEndOfCurrentMonth(d(1, FEBRUARY,2006))); 

397 assertEquals(d(31, MARCH, 2006), 
d.getEndOfCurrentMonth(d(1, MARCH, 2006))); 

398 assertEquals(d(30, APRIL, 2006), 


d.getEndOfCurrentMonth(d(1, APRIL, 2006))); 


399 assertEquals(d(31, MAY, 2006), 
d.getEndOfCurrentMonth(d(1, MAY, 2006))); 


400 assertEquals(d(30, JUNE, 2006), 
d.getEndOfCurrentMonth(d(1, JUNE, 2006))); 

401 assertEquals(d(31, JULY, 2006), 
d.getEndOfCurrentMonth(d(1, JULY, 2006))); 

402 assertEquals(d(31, AUGUST, 2006), 
d.getEndOfCurrentMonth(d(1, AUGUST, 2006))); 

403 assertEquals(d(30, SEPTEMBER, 2006), 


d.getEndOfCurrentMonth 
(d(1, SEPTEMBER, 2006))); 


404 assertEquals(d(31, OCTOBER, 2006), 
d.getEndOfCurrentMonth(d(1, OCTOBER, 2006))); 

405 assertEquals(d(30, NOVEMBER,2006), 
d.getEndOfCurrentMonth(d(1, NOVEMBER,2006))); 

406 assertEquals(d(31, DECEMBER,2006), 
d.getEndOfCurrentMonth(d(1, DECEMBER, 2006))); 

407 assertEquals(d(29, FEBRUARY,2008), 
d.getEndOfCurrentMonth(d(1, FEBRUARY,2008))); 

408 } 

409 


410 public void testWeekInMonthToString() throws Exception 


411 
assertEquals("First",weekInMonthToString(FIRST_WEEK_IN_MONTH)); 

412 
assertEquals("Second",weekInMonthToString(SECOND_WEEK_IN_MONT 


413 
assertEquals("Third",weekInMonthToString(THIRD_WEEK_IN_MONTH)); 

414 
assertEquals("Fourth",weekInMonthToString(FOURTH_WEEK_IN_MONTI 

415 
assertEquals("Last",weekInMonthToString(LAST_WEEK_IN_MONTH)); 

416 

417 //todo try { 


418 // weekInMonthToString(-1); 

419 // fail("Invalid week code should throw exception"); 

420 // } catch (IllegalArgumentException e) { 

421 // } 

422 } 

423 

424 public void testRelativeToString() throws Exception { 
425 assertEquals("Preceding",relativeToString(PRECEDING)); 
426 assertEquals("Nearest",relativeToString(NEAREST)); 

427 assertEquals(" Following" ,relativeToString(FOLLOWINQG)); 
428 

429 //todo try 1 

430 // relativeToString(-1000); 

431 // fail("Invalid relative code should throw exception"); 


432 // } catch (IllegalArgumentException e)1 
433 // } 


436 public void testCreateInstanceFromDDMMYYY() throws 


Exception { 


437 SerialDate date = createInstance(1, JANUARY, 1900); 
438 assertEquals(1,date.getDayOfMonth()); 

439 assertEquals(JANUARY ,date.getMonth()); 

440 assertEquals(1900,date.getY Y Y Y ()); 

441 assertEquals(2,date.toSerial()); 

442 } 

443 

444 public void testCreateInstanceFromSerial() throws 


Exception 1 


445 assertEquals(d(1, JANUARY, 1900),createInstance(2)); 

446 assertEquals(d(1, JANUARY, 1901), createInstance(367)); 
447 } 

448 

449 public void testCreateInstanceFromJavaDate() throws 


Exception 1 


450 assertEquals(d(1, JANUARY, 1900), 
createInstance(new 
GregorianCalendar(1900,0,1).getTime())); 
451 assertEquals(d(1, JANUARY, 2006), 
createInstance(new 


GregorianCalendar(2006,0,1).getTime())); 
452 } 
453 
454 public static void main(String[] args) { 
455 junit.textui. TestRunner.run(BobsSerialDateTest.class); 
456 } 


457 } 
代码 清单 B-5 SpreadsheetDate.java 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or 
modify it 

10 * under the terms of the GNU Lesser General Public 
License as published by 

11 *theFree Software Foundation; either version 2.1 of the License, 
or 

12 *(at your option) any later version. 

13. * 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY 

16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 


Lesser General Public 


17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser 
General Public 

20 * License along with this library; if not, write to the Free 
Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, 

22 * USA. 

2o LR 

24 * [Java is a trademark or registered trademark of Sun 
Microsystems, Inc. 


25 *inthe United States and other countries. |] 


26 * 

I dés dec opido 

28 * SpreadsheetDate.java 
29 Ri? m iere eii 


30 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

31 5 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 


34 * 

35 * $Id: SpreadsheetDate.java,v 1.8 2005/11/03 09:25:39 mungady 
Exp $ 

36 * 


37 * Changes 


38 * ieas 

39 * 11-Oct-2001 : Version 1 (DG); 

40 * 05-Nov-2001 : Added getDescription() and setDescription() 
methods (DG); 

41 * 12-Nov-2001 : Changed name from ExcelDate.java to 
SpreadsheetDate.java (DG); 

42 * Fixed a bug in calculating day, 
month and year from serial 

43 * number (DG); 

44 * 24-Jan-2002 : Fixed a bug in calculating the serial number 
from the day, 

45 * month and year. Thanks to Trevor 
Hills for the report (DG); 

46 * 29-May-2002 : Added equals(Object) method (SourceForge 
ID 558850) (DG); 

47 * 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

48 * 13-Mar-2003 : Implemented Serializable (DG); 

49 * 04-Sep-2003 : Completed isInRange() methods (DG); 

50 * 05-Sep-2003 : Implemented Comparable (DG); 

51 * 21-Oct-2003 : Added hashCode() method (DG); 

52. 这 

o3 #7 

54 

55 package org.jfree.date; 

56 

57 import java.util.Calendar; 


58 import java.util.Date; 


59 

60 /** 

61 * Represents a date using an integer, in a similar fashion to 
the 

62 * implementation in Microsoft Excel. The range of dates 
supported is 

63 *1-Jan-1900 to 31-Dec-9999. 

64 *<P> 

65 * Be aware that there is a deliberate bug in Excel that recognis es 
the year 

66 *19008sa leap year when in fact it is not a leap year. You can 
find more 


67 *information on the Microsoft website in article Q181370: 


68 *<P> 
69 *http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 
70 <P> 


71 * Excel uses the convention that 1-Jan-1900 = 1. This class 
uses the 

72 * convention 1-Jan-1900 = 2. 

73 * The result is that the day number in this class will be 
different to the 

74 * Excel figure for January and February 1900...but then Exce | adds 
in an extra 

75 * day (29-Feb-1900 which does not actually exist!) and from that 
point forward 

76 * the day numbers will match. 

Vo ala 


78 * @author David Gilbert 

79 */ 

80 public class SpreadsheetDate extends SerialDate | 
81 


82 /** For serialization. */ 

83 private static final long serial VersionUID 
= -2039586705374454461L; 

84 

85 [EX 

86 * The day number (1-Jan-1900 = 2, 2-Jan-1900 = 3, ..., 
31-Dec-9999 = 

87 * 2958465). 

88 id 

89 private int serial; 

90 

91 /** The day of the month (1 to 28, 29, 30 or 31 
depending onthe month). */ 

92 private int day; 

93 

94 /** The month of the year (1 to 12). */ 

95 private int month; 

96 

97 /** The year (1900to 9999). */ 

98 private int year; 

99 

100 /** An optional description forthe date. */ 


101 private String description; 


102 
103 
104 
105 
106 
107 
108 
109 
110 


int year) { 


111 
112 
113 
114 
115 
116 
117 
1900 to 
118 
119 
120 
121 
122 


/ 米 米 


* Createsa new date instance. 

* 

* @param day the day (in the range 1 to 28/29/30/31). 

* @param month the month (in the range 1to 12). 

* @param year the year (inthe range 1900to 9999). 
wi 

public SpreadsheetDate(final int day, final int month, final 


if ((year >= 1900) && (year <= 9999)) { 


this.year = year; 


9999." 


} 
else { 
throw new IllegalArgumentException( 
"The 'year argument must be in range 
); 
} 


if (month >= MonthConstants JANUARY) 
&& (month <= 


MonthConstants.DECEMBER)) 1 


123 
124 
125 


this.month = month; 


else { 


126 throw new IllegalArgumentException( 
127 "The 'month' argument must be in the 


range 1 to 12." 


128 y 

129 } 

130 

131 if ((day >= 1) && (day <= 
SerialDate.lastDayOfMonth(month, year))) { 

132 this.day = day; 

133 } 

134 else { 

135 throw new IllegalArgumentException("Invalid 
day argument."); 

136 } 

137 

138 // the serial number needs to be synchronised with 


the day-month-year... 

139 this.serial = calcSerial(day, month, year); 

140 

141 this.description = null; 

142 

143 } 

144 

145 hs 

146 * Standard constructor - creates a new date object 
representing the 


147 * specified day number (which should be in the range 


2 to 2958465. 

148 di 

149 * @param serial the serial number for the day (range: 2 
to 2958465). 

150 dii 

151 public SpreadsheetDate(final int serial) { 

152 

153 if ((serial >= SERIAL LOWER_BOUND) && (serial <= 
SERIAL _UPPER_BOUND)) { 

154 this.serial = serial; 

155 } 

156 else { 

157 throw new IllegalArgumentException( 

158 "SpreadsheetDate: Serial must be in 
range 2 to 2958465."); 

159 } 

160 

161 // the day-month-year needs to be synchronised 
with the serial number... 

162 calcDayMonthY ear(); 

163 

164 } 

165 

166 hss 

167 * Returns the description that is attached to the date. It is 
not 


168 * required that a date have a description, but for some 


applications it 


169 * is useful. 

170 * 

171 * @return The description that is attached to the date. 

172 £^ 

173 public String getDescription() 1 

174 return this.description; 

175 } 

176 

177 prm 

178 * Sets the description for the date. 

179 * 

180 * @param description the description for this date 
(<code>null</code> 

181 m permitted). 

182 */ 

183 public void setDescription(final String description) { 

184 this.description = description; 

185 } 

186 

187 JER 

188 * Returns the serial number for the date, where 1 January 
1900= 2 

189 * (this corresponds, almost, to the numbering system 


used in Microsoft 
190 * Excel for Windows and Lotus 1-2-3). 
191 x 


192 
193 
194 
195 
196 
197 
198 
199 
date. 
200 
201 
202 
203 
204 
205 


* @return The serial number of this date. 
mi 
public int toSerial() 1 


return this.serial; 


/ 米 米 


* Returns a <code>java.util.Date</code> equivalent to this 


* 


* @return The date. 

zi 

public Date toDate() 1 
final Calendar calendar = Calendar.getInstance(); 
calendar.set(getY YYY(), getMonth() - 1, 


getDayOfMonth(), 0, 0, 0); 


206 
207 
208 
209 
210 

9999). 
211 
212 
213 
214 
215 


return calendar.getTime(); 


[E 


* Returns the year (assume a valid range of 1900 to 


* 

* @return The year. 

*/ 

public int getYYYY() { 


return this.year; 


216 } 


217 

218 [ER 

219 * Returns the month (January = 1, February = 2, March 
= 3). 

220 * 

221 * @return The month of the year. 

222 */ 

223 public int getMonth() { 

224 return this.month; 

225 } 

226 

227 pm 

228 * Returns the day of the month. 

229 d 

230 * @return The day of the month. 

231 Si 

232 public int getDayOfMonth() { 

233 return this.day; 

234 } 

235 

236 [re 

237 * Returnsa code representing the day ofthe week. 

238 * <P> 

239 * The codes are defined in the {@link SerialDate} 
class as: 


240 * <code>SUNDAY</code>, <code>MONDAY </code>, 


<code>TUESDA Y</code>, 


241 


* <code>WEDNESDAY </code>, 


«code» THURSDAY </code>, <code>FRIDAY </code>, and 


242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
object. 
252 
253 
instance 
254 


* <code>SATURDAY </code>. 

* 

* @return A code representing the day ofthe week. 
3 
public int getDayOfWeek() { 

return (this.serial + 6)% 7+ 1; 

} 
LI 

* Tests the equality of this date with an arbitrary 
* <P> 

* This method will return true ONLY if the object is an 

of the 
* {@link SerialDate} base class, and it represents the 


same day as this 


255 
256 
257 


* {@link SpreadsheetDate}. 


* 


*  (Qparam object the object to compare 


(<code>null</code> permitted). 


258 
259 
260 
261 


* 


* @retum A boolean. 
mi 
public boolean equals(final Object object) { 


262 


263 if (object instanceof  SerialDate) { 

264 final SerialDate s=(SerialDate) object; 

265 return (s.toSerial() == this.toSerial()); 

266 } 

267 else { 

268 return false; 

269 } 

270 

271 } 

272 

273 [a 

274 * Returnsa hash code for this object instance. 

275 * 

276 * @return A hash code. 

277 */ 

278 public int hashCode() { 

279 return toSerial(); 

280 } 

281 

282 Ps 

283 * Returns the difference (in days) between this date and 
the sp ecified 

284 * 'other date. 

285 = 

286 * @param other the date being compared to. 


287 m 


288 * @return The difference (in days) between this date 
and the specified 


289 * 'other' date. 

290 i 

291 public int compare(final SerialDate other) { 

292 return this.serial - other.toSerial(); 

293 } 

294 

295 E 

296 * Implements the method required by the Comparable 
interface. 

297 m 

298 * (gparam other the other object (usually another 
SerialDate). 

299 id 

300 * (greturn A negative integer, zero, or a positive 


integer as this object 
301 * is less than, equal to, or greater than the 


specified object. 


302 mi 

303 public int compareTo(final Object other) 1 

304 return compare((SerialDate) other); 

305 } 

306 

307 pm 

308 * Returns true if this SerialDate represents the same date 


as the 


309 
310 
311 
312 
313 

the same date 
314 
315 
316 
317 
318 
319 
320 
321 

compared to 
322 
323 
324 
325 
326 

an earlier date 
327 
328 
329 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


as 

d the specified SerialDate. 

*/ 

public boolean isOn(final SerialDate other) { 
return (this.serial == other.toSerial()); 

} 

pee 


* Returns true if this SerialDate represents an earlier date 


* the specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


m compared to the specified SerialDate. 
3 
public boolean isBefore(final SerialDate other) 1 


return (this.serial « other.toSerial()); 


333 
334 
as the 
335 
336 
337 
338 
339 
the same date 
340 
341 
342 
343 
344 
345 
346 
347 
as the 
348 
349 
350 
351 
352 
the same date 
353 
354 
355 


[** 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


a as the specified SerialDate. 
e 
public boolean isOnOrBefore(final SerialDate other) 1 


return (this.serial <= — other.toSerial()); 


[E 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents 


T as the specified SerialDate. 
*/ 
public boolean isAfter(final SerialDate other) { 


356 
357 
358 
359 
360 
as the 
361 
362 
363 
364 
365 
the same date 
366 
367 
368 
369 
370 
371 
372 
373 
within the 
374 
and d2 is not 
375 
376 
377 
378 


return (this.serial > other.toSerial()); 


[E 


* Returns true if this SerialDate represents the same date 


* specified SerialDate. 


* 


* @param other the date being compared to. 


* 
* @return <code>true</code> if this SerialDate represents 
as 
ti the specified SerialDate. 
mi 
public boolean isOnOrAfter(final SerialDate other) 1 


return (this.serial >=  other.toSerial()); 


[E 


* Returns <code>true</code> if this {@link SerialDate} is 


* specified range (INCLUSIVE). The date order of d1 


* important. 
* 
* @param dl aboundary date for the range. 
* @param d2 the other boundary date for the 


379 ù 

380 * @return A boolean. 

381 zi 

382 public boolean isInRange(final SerialDate  d1, final 
SerialDate d2) 1 

383 return isInRange(d1, d2, SerialDate.[INCLUDE BOTH); 

384 } 

385 

386 pum 

387 * Returns true if this SerialDate is within the specified 


range (caller 


388 * specifies whether or not the end-points are included). 
The order of dl 

389 * and d2 is not important. 

390 * 

391 * @param d1 one boundary date for the range. 

392 * @param d2 a second boundary date for the range. 

393 * @param include a code that controls whether or not 


the start and end 


394 a dates are included in the 
range. 

395 x 

396 * @return <code>true</code> if this SerialDate is within 


the specified 
397 di range. 
398 2 


SerialDate d2, 


399 


400 


include) 


year. 


401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 


public boolean  isInRange(final SerialDate d1, final 


final int 


finalints1= dl.toSerial(); 
finalints2=  d2.toSerial(); 
final int start = Math.min(s1, S2); 
final int end = Math.max(s1, s2); 


finalints-  toSerial(); 
if (include == SerialDate.I[INCLUDE BOTH) { 
return (s >= start && s <= end); 
i 
else if (include == SerialDate.I[INCLUDE FIRST) { 
return (s >= start && s < end); 
j 
else if (include == SerialDate. [:NCLUDE SECOND) { 


return (s > start && s <= end); 


} 
else { 
return (s > start && s< end); 
} 
} 
[ee 


* Calculate the serial number from the day, month and 


423 * <P> 


424 * 1-Jan-1900 =2. 

425 x 

426 * @paramd the day. 

427 * @paramm the month. 

428 * @paramy the year. 

429 x 

430 * @return the serial number from the day, month and 
year. 

431 di 

432 private int calcSerial(final int d, final int m, final int 
y)1 

433 final int yy = ((y - 1900 * 365) + 
SerialDate.leapYearCount(y - 1); 

434 int mm = 
SerialDate. AGGREGATE DAYS TO END OF PRECEDING MONTH[m 

435 if (m » MonthConstants. FEBRUARY) ( 

436 if (SerialDate.isLeap Year(y)) { 

437 mm - mm + 1; 

438 } 

439 } 

440 final int dd = d; 

441 return yy+mm +dd+ 1; 

442 } 

443 

444 [oe 


445 * Calculate the day, month and year from the serial 


number. 


446 di 

447 private void calcDayMonthYear() 1 

448 

449 // get the year from the serial date 

450 final int days = this.serial - SERIAL LOWER, BOUND; 

451 // overestimated because we ignored leap days 

452 final int overestimatedYYYY = 1900 + (days / 
365); 

453 final int leaps - 
SerialDate.leap Y earCount(overestimatedY Y Y Y); 

454 final int nonleapdays = days - leaps; 

455 // underestimated because we overestimated years 

456 int underestimatedYYYY = 1900 + (nonleapdays 
/ 365); 

457 

458 if (underestimatedY YYY == overestimatedY Y Y Y) | 

459 this.year = underestimatedY Y Y Y; 

460 } 

461 else { 

462 int ssl = calcSerial(1, 1, 
underestimatedY Y Y Y); 

463 while (ss1 <= this.serial) 1 

464 underestimatedYYYY = 
underestimatedY Y Y Y + 1; 

465 ssl = calcSerial(1, Te 


underestimatedY Y Y Y); 


466 } 
467 this.year = underestimatedYYYY - 1; 
468 } 
469 
470 final int ss2 = calcSerial(1, 1, this.year); 
471 
472 int[] daysToEndOfPrecedingMonth 
473 = 
AGGREGATE DAYS TO END OF PRECEDING MONTH; 
474 


475 if (isLeapYear(this.year)) 1 

476 daysToEndOfPrecedingMonth 

477 = 
LEAP_YEAR_AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONT 

478 } 

479 

480 // get the month from the serial date 

481 int mm = 1; 

482 int SSS = SS2 + 
daysToEndOfPrecedingMonth[mm]  - 1; 

483 while (sss < this.serial) { 

484 mm=mm +1; 

485 SSS = SS2 十 
daysToEndOfPrecedingMonth[mm] - 1; 

486 } 

487 this.month - mn - 1; 


488 


489 // what's left is d(+1); 

490 this.day =this.serial - ss2 

491 - 
daysToEndOfPrecedingMonth[this.month] + 1; 

492 


494 
495 } 
代码 清单 B-6 RelativeDayOfWeekRule.java 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 

6 * 

7 * Project Info: http://www.jfree.org/jcommon/index.html 

8 * 

9 * This library is free software; you can redistribute it and/or 
modify it 

10 * under the terms of the GNU Lesser General Public 
License as published by 

11 * the Free Software Foundation; either version 2.1 of the License, 


Or 


12 *(at your option) any later version. 

13 * 

14 * This library is distributed inthe hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY 

16 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
Lesser General Public 

17 * License for more details. 

18 * 

19 * You should have received a copy of the GNU Lesser 
General Public 

20 * License along with this library; if not, write to the Free 
Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110-1301, 

22 * USA. 

go 

24 * [Java is a trademark or registered trademark of Sun 
Microsystems, Inc. 


25 *inthe United States and other countries. | 


26 * 

2 7 Cc ÓNE 

28 * RelativeDayOfWeekRule.java 
29 fi: silenzio eee 


30 * (C) Copyright 2000-2003, by Object Refinery Limited and 
Contributors. 
31 C 


32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 

34 * 

35: 7 $Id: RelativeDayOfWeekRule.java,v 1.6 2005/11/16 
15:58:40 taqua Exp $ 

36 * 

37 * Changes (from 26-Oct-2001) 

co PE e 

39 * 26-Oct-2001 : Changed package to com.jrefinery.date.*; 

40  * 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

41 * 

42 */ 

43 

44 package org.jfree.date; 

45 

46 /** 

47 * An annual date rule that returns a date for each year based 
on(a) a 

48 *reference rule; (b)aday ofthe week; and (c) a selection 
parameter 

49 * (SerialDate.PRECEDING, SerialDate. NEAREST, 
SerialDate. FOLLOWING ). 

50 *<P> 

51 * For example, Good Friday can be specified as 'the Friday 
PRECEDING Easter 

52 * Sunday! 

Da, * 


54 * author David Gilbert 


ob. "M 

56 public class RelativeDayOfWeekRule extends AnnualDateRule { 

57 

58 /** A reference to the annual date rule on which this rule 
is based. */ 

59 private AnnualDateRule  subrule; 

60 

61 is 

62 * The day of the week (SerialDate MONDAY, 
SerialDate.TUESDAY, and so on). 

63 */ 

64 private int dayOfWeek; 

65 

66 /** Specifies which day of the week (PRECEDING, 
NEAREST or FOLLOWING). */ 

67 private int relative; 

68 

69 isa 

70 * Default constructor - builds a rule for the Monday 


following1 January. 


71 */ 

72 public RelativeDayOfWeekRule() { 

73 thisspew DayAndMonthRule(), 
SerialDate. MONDAY, SerialDate. FOLLOWING); 

74 } 


75 


76 [ae 


77 * Standard constructor - builds rule based on the supplied 
sub-rule. 

78 = 

79 * @param subrule the rule that determines the 


reference date. 

80 * @param dayOfWeek the day-of-the-week relative to the 
reference date. 

81 * (gparam relative indicates *which* day-of-the-week 


(preceding, nearest 


82 È or following). 

83 */ 

84 public RelativeDayOfWeekRule(final ^ AnnualDateRule 
subrule, 

85 final int dayOfWeek, final int relative) { 

86 this.subrule = subrule; 

87 this.dayOfWeek = | dayOfWeek; 

88 this.relative = relative; 

89 } 

90 

91 [PE 

92 * Returns the sub-rule (also called the reference rule). 

93 = 

94 * @return The annual date rule that determines the 


reference date for this 
95 > rule. 
96 */ 


97 

98 

99 

100 
101 
102 
103 
104 

reference date 

105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 


public AnnualDateRule  getSubrule() 1 


return this.subrule; 


/ 米 米 


* Sets the sub-rule. 


* 


* @param subrule the annual date rule that determines the 


* for this rule. 
e 
public void setSubrule(final AnnualDateRule subrule) { 


this.subrule = subrule; 


/ 米 米 


* Returns the day-of-the-week for this rule. 


* 


* @return the day-of-the-week for this rule. 


zi 

public int getDayOfWeek() { 
return this.dayOfWeek; 

j 

[** 


* Sets the day-of-the-week for this rule. 


* 


123 *  @param dayOfWeek the day-of-the-week 
(SerialDate. MONDAY, 

124 à SerialDate. TUESDAY, 
and soon). 

125 £^ 

126 public void setDayOfWeek(final int dayOfWeek) 1 

127 this.dayOfWeek = dayOfWeek; 

128 } 

129 

130 prm 

131 * Returns the 'relative' attribute, that determines *which* 

132 ^ day-of-the-week we are interested in 
(SerialDate. PRECEDING, 

133 * SerialDate. NEAREST or SerialDate. FOLLOWING). 

134 d 

135 * @return The 'relative' attribute. 

136 Si 

137 public int getRelative() { 

138 return this.relative; 

139 } 

140 

141 [am 

142 * Sets the ‘relative’ attribute (SerialDate. PRECEDING, 
SerialDate. NEAREST, 

143 * SerialDate. FOLLOWING). 

144 * 

145 * (gparam relative determines *which* day-of-the-week 


is selected bythis 


146 * rule. 

147 */ 

148 public void setRelative(final int relative) { 

149 this.relative = relative; 

150 } 

151 

152 pn 

153 * Createsa  cloneof this rule. 

154 i 

155 * @returna cloneof this rule. 

156 = 

157 * (gthrows CloneNotSupportedException this should 
never happen. 

158 ui 

159 public Object clone() throws CloneNotSupportedException 
{ 

160 final RelativeDayOfWeekRule duplicate 

161 = (RelativeDayOfWeekRule) super.clone(); 

162 duplicate.subrule = (AnnualDateRule) 
duplicate.getSubrule().clone(); 

163 return duplicate; 

164 } 

165 

166 Es 

167 * Returns the date generated by this rule, for the 


specified year. 


168 
169 
170 
171 
year (possibly 
172 
173 
174 
175 
176 
177 
178 


* 


* @param year the year (1900 &lt;= year &lt;- 9999). 


* 


* @return The date generated by the rule for the given 


m <code>null</code>). 
g 
public SerialDate getDate(final int year) { 


// check argument... 
if ((year < SerialDate. MINIMUM YEAR, SUPPORTED) 


| (year > 


SerialDate. MAXIMUM YEAR SUPPORTED)) { 


179 
180 


throw new IllegalArgumentException( 


"RelativeDayOfWeekRule.getDate(): year 


outside valid range."); 


181 
182 
183 
184 
185 
186 
187 
188 
189 
190 


} 


// calculate the date... 
SerialDate result = null; 


final SerialDate base = this.subrule.getDate(year); 


if (base != null) { 
switch (this.relative) { 
case(SerialDate. PRECEDING): 


result = 


SerialDate.getPreviousDayOfWeek(this.dayOfWeek, 


191 base); 


192 break; 

193 case(SerialDate. NEAREST): 

194 result = 
SerialDate.getNearestDayOfWeek(this.dayOfWeek, 

195 base); 

196 break; 

197 case(SerialDate. FOLLOWING): 

198 result = 
SerialDate.getFollowingDayOfWeek(this.dayOfWeek, 

199 base); 

200 break; 

201 default: 

202 break; 

203 j 

204 } 

205 return result; 

206 

207 } 

208 

209 } 

代码 清单 B-7 DayDate.java (最 终 版 本 ) 

1 ps 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 


Contributors. 


36 */ 
37 package org.jfree.date; 
38 


39 import java.io.Serializable; 

40 import java.util.*; 

41 

42 /** 

43 * An abstract class that represents immutable dates with a 
precision of 

44 * one day. The implementation will map each date to an 
integer that 

45 *represents an ordinal number of days from some fixed origin. 

46 * 

47 * Why not just use java.util.Date? We will, when it makes 
sense. At times, 

48 * java.util.Date can be *too* precise - it represents an instant 
in time, 

49 *accurate to 1/1000th ofa second (with the date itself dependin 
g on the 

50 * time-zone). Sometimes we just want to represent a particular 
day (e.g. 21 


51 * January 2015) without concerning ourselves about the time of 


day, or the 


52 * time-zone, or anything else. Thats what we've defined 
DayDate for. 

og * 

54 * Use DayDateFactory.makeDate to create an instance. 

one 

56 * @author David Gilbert 


57 
58 
59 


* @author Robert C. Martin did a lot of refactoring. 
*/ 


60 public abstract class DayDate implements Comparable, Serializable { 


61 public abstract int getOrdinalDay(); 

62 public abstract int getYear(); 

63 public abstract Month getMonth(); 

64 public abstract int getDayOfMonth(); 

65 

66 protected abstract Day getDayOfWeekForOrdinalZero(); 

67 

68 public DayDate plusDays(int days) { 

69 return DayDateFactory.makeDate(getOrdinalDay() + days); 

70 } 

71 

72 public DayDate plusMonths(int months) { 

73 int thisMonthAsOrdinal = getMonth().toInt() - 
Month.JANUARY .toInt(); 

74 int thisMonthAndYearAsOrdinal = 12 * getYear() + 


thisMonthAsOrdinal; 


75 int resultMonthAndY earAsOrdinal = 
thisMonthAndYearAsOrdinal + months; 


76 int resultYear = resultMonthAndYearAsOrdinal / 12; 

77 int resultMonthAsOrdinal=resultMonthAndYearAsOrdinal % 
12+Month JANUARY.toInt(); 

78 Month resultMonth = Month.fromInt(resultMonthAsOrdinal); 

79 int resultDay = correctLastDayOfMonth(getDayOfMonth(), 
resultMonth, result Year); 

80 return DayDateFactory.makeDate(resultDay, resultMonth, 
result Y ear); 

81 } 

82 

83 public DayDate plusYears(int years) { 

84 int resultYear = getYear() + years; 

85 int resultDay = correctLastDayOfMonth(getDayOfMonth(), 
getMonth(), resultY ear); 

86 return DayDateFactory.makeDate(resultDay, getMonth(), 
result Y ear); 

87 } 

88 

89 private int correctLastDayOfMonth(int day, Month month, 
int year) { 

90 int lastDayOfMonth =  DateUtil.lastDayOfMonth(month, 
year); 

91 if (day > lastDayOfMonth) 

92 day = lastDayOfMonth; 


93 return day; 


94  ] 


95 

96 public DayDate getPreviousDayOfWeek(Day 
targetDayOfWeek) 1 

97 int offsetToTarget - targetDayOfWeek.toInt() - 
getDayOfWeek().toInt(); 

98 if (offsetToTarget >= 0) 

99 offsetToTarget -= 7; 

100 return plusDays(offsetToTarget); 

101 } 

102 

103 public DayDate getFollowingDayOfWeek(Day 
targetDayOfWeek) { 

104 int offsetToTarget = targetDayOfWeek.toInt() - 
getDayOfWeek().toInt(); 

105 if (offsetToTarget <= 0) 

106 offsetToTarget += 7; 

107 return plusDays(offsetToTarget); 

108 } 

109 

110 public DayDate getNearestDayOfWeek(Day 
targetDayOfWeek) { 

111 int offsetToThisWeeksTarget = targetDayOfWeek.toInt()  - 
getDayOfWeek().toInt(); 

112 int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) 


% 7; 
113 int offsetToPreviousTarget = offsetToFutureTarget - 7; 


115 if (offsetToFutureTarget > 3) 

116 return plusDays(offsetToPreviousTarget); 

117 else 

118 return plusDays(offsetToFutureTarget); 

119 } 

120 

121 public DayDate getEndOfMonth() { 

122 Month month = getMonth(); 

123 int year = getYear(); 

124 int lastDay = DateUtil.lastDayOfMonth(month, year); 

125 return DayDateFactory.makeDate(lastDay, month, year); 

126 } 

127 

128 public Date toDate() 1 

129 final Calendar calendar = Calendar.getInstance(); 

130 int ordinalMonth = getMonth().toInt() - 
Month.JANUARY .toInt(); 

131 calendar.set(getYear(), ordinalMonth, getDayOfMonth(), 
0, 0,0); 

132 return calendar.getTime(); 

133 } 

134 

135 public String toString() { 

136 return String.format("%02d-%s-%d", | getDayOfMonth(), 


getMonth(), get Year()); 
137 } 


138 
139 public Day getDayOfWeek() 1 


140 Day startingDay = getDayOfWeekForOrdinalZero(); 

141 int startingOffset = startingDay.toInt() - 
Day.SUNDAY .toInt(); 

142 int ordinalOfbayOfWeek =  (getOrdinalDay) + 
startingOffset) % 7; 

143 return Day.fromInt(ordinalOfDayOfWeek 十 
Day.SUNDAY .toInt()); 

144 } 

145 

146 public int daysSince(DayDate date) { 

147 return getOrdinalDay() - date.getOrdinalDay(); 

148 } 

149 

150 public boolean isOn(DayDate other) { 

151 return getOrdinalDay() == other.getOrdinalDay(); 

152 } 

153 

154 public boolean isBefore(DayDate other) { 

155 return getOrdinalDay() < other.getOrdinalDay(); 

156 } 

157 

158 public boolean isOnOrBefore(DayDate other) { 

159 return getOrdinalDay() <= other.getOrdinalDay(); 

160 } 


161 


162 public boolean isAfter(DayDate other) { 


163 return getOrdinalDay() > other.getOrdinalDay(); 
164 } 

165 

166 public boolean isOnOrAfter(DayDate other) { 

167 return getOrdinalDay() >= other.getOrdinalDay(); 
168 } 

169 

170 public boolean isInRange(DayDate d1, DayDate | d2) { 
171 return isInRange(d1, d2, DateInterval. CLOSED); 
172 } 

173 


174 public boolean isinRange(DayDate di, DayDate d2, 


DateInterval interval) { 


175 int left = Math.min(d1.getOrdinalDay(), 
d2.getOrdinalDay()); 

176 int right = Math.max(d1.getOrdinalDay(), 
d2.getOrdinalDay()); 

177 return interval.isIn(getOrdinalDay(), left, right); 

178 } 

179 } 

代码 清单 B-8 Month.java 〈 最 终 版 本 ) 

1 package org.jfree.date; 

2 


3 import java.text.DateFormatSymbols; 
4 
5 public enum Month { 


6 JANUARY(1), FEBRUARY(2), MARCH(3), 
7 APRIL(4), MAY(5)， JUNE(6), 

8  JULY(7), AUGUST(8), | SEPTEMBER(9), 
9  OCTOBER(10),NOVEMBER(11),DECEMBER(12); 


10 private static DateFormatSymbols dateFormatSymbols = new 
DateFormatSymbols(); 

11 private static final int[] LAST DAY OF MONTH = 

12 {0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}; 

13 

14 private int index; 

15 

16 Month(int index) 1 

17 this.index = index; 

18 } 

19 

20 public static Month fromInt(int monthIndex) { 

21 for (Month m. : Month.values()) 1 

22 if (m.index == monthIndex) 

23 return m; 

24 } 

25 throw new IllegalArgumentException("Invalid month index 


" 


+ monthIndex); 
26 } 
27 
28 public int lastDay() 1 
29 return LAST DAY OF MONTH[index]; 
30 } 


31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 


public int quarter() 1 


return 1 + (index - 1) /3; 


public String toString() { 
return dateFormatSymbols.getMonths()[index - 1]; 


public String toShortString() 1 
return dateFormatSymbols.getShortMonths()[index - 1]; 


public static Month parse(String s) { 
s = s.trim(); 
for (Month m  : Month.values()) 
if (m.matches(s)) 


return m; 


try 1 
return fromInt(Integer.parseInt(s)); 


} 


catch (NumberFormatException e) {} 


throw new IllegalArgumentException("Invalid month " + s); 


private boolean matches(String s) { 


58 return s.equalsIgnoreCase(toString()) || 


59 s.equalsIgnoreCase(toShortString()); 
60 } 

61 

62 public int toInt() { 

63 return index; 

64 } 

65 } 

代码 清单 B-9 Day.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 


3 import java.util.Calendar; 

4 import java.text.DateFormatSymbols; 

5 

6 public enum Day { 

7 MONDAY(Calendar. MONDAY), 

8 TUESDAY(Calendar. TUESDAY), 

9 WEDNESDAY (Calendar. WEDNESDAY), 
10 THURSDAY(Calendar. THURSDAY), 
11 FRIDAY (Calendar.FRIDAY), 

12 SATURDAY(Calendar. SATURDAY), 
13 SUNDAY (Calendar.SUNDA Y); 


14 

15 private final int index; 

16 private static  DateFormatSymbols dateSymbols = new 
DateFormatSymbols(); 


17 


18 Day(int day) { 


19 index = day; 

20 } 

21 

22 public static Day fromInt(int index) throws 
IllegalArgumentException 1 

23 for (Day d: Day.values()) 

24 if (dindex == index) 

25 return d; 

26 throw new IllegalArgumentException( 

27 String.format("Illegal day index: %d.", index)); 

28 } 

29 

30 public static Day parse(String S) throws 
IllegalArgumentException 1 

31 String[] shortWeekdayNames = 

32 dateSymbols.getShortWeekdays(); 

33 String[] weekDayNames = 

34 dateSymbols.getWeekdays(); 

35 

36 s = s.trim(); 

37 for (Day day : Day.values()) { 

38 if (s.equalsIgnoreCase(shortWeekdayNames[day.index |) || 

39 s.equalsIgnoreCase(weekDayNames[day.index])) { 

40 return day; 

41 } 


42 } 


43 throw new Illegal ArgumentException( 


44 String.format("%s is not a valid weekday string", s)); 
45 } 

46 

47 public String toString() { 

48 return dateSymbols.getWeekdays()[index]; 
49 } 

50 

51 public int toInt() { 

52 return index; 

53 } 

54 } 


代码 清单 B-10 DateInterval.java 〈 最 终 版 本 ) 
1 package org.jfree.date; 


2 

3 public enum Datelnterval { 

4 OPEN { 

5 public boolean isIn(int d,int left, int right) { 
6 returnd >left && d< right; 

7 } 

8 J; 

9 CLOSED LEFT { 

10 public boolean isIn(int d, int left, int right) { 
11 return d >= left && d< right; 

12 } 

13 1 


14 CLOSED RIGHT { 


15 public boolean isIn(int d, int left, int right) { 


16 return d > left &&d<= right; 
17 } 

18 b 

19 CLOSED { 


20 public boolean isIn(int d, int left, int right) { 


21 return d >= left && d <= right; 

22 } 

23- Xp 

24 

25 public abstract boolean isIn(int d, int left, 
26 } 


代码 清单 B-11 WeekInMonth.java (最 终 版 本 ) 


1 package org.jfree.date; 
2 
3 public enum WeekInMonth { 


4 FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0) 


private final int index; 


5 

6 

7 WeekInMonth(int index) { 
8 this.index = index; 

9 


} 
10 
11 public int toInt() { 
12 return index; 
13 } 


int right); 


5 


代码 清单 B-12 WeekdayRange.java (最 终 版 本 ) 
1 package org.jfree.date; 

2 

3 public enum WeekdayRange { 

4 LAST, NEAREST, NEXT 


5j 

代码 清单 B-13 DateUtil.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.text.DateFormatSymbols; 

4 

5 public class DateUtil { 

6 private static DateFormatSymbols dateFormatSymbols = new 
DateFormatSymbols(); 

7 

8 public static String[] getMonthNames() 1 

9 return dateFormatSymbols.getMonths(); 

10 } 

11 

12 public static boolean isLeapYear(int year) { 

13 boolean fourth = year % 4 == 0; 

14 boolean hundredth = year % 100 == 0; 

15 boolean fourHundredth =year% 400== 0; 

16 return fourth && (!hundredth || fourHundredth); 

17 } 

18 


19 public static int lastDayOfMonth(Month month, int year) 1 


20 if (month == Month. FEBRUARY && isLeapYear(year)) 


21 return month.lastDay() + 1; 

22 else 

23 return month.lastDay(); 

24 } 

25 

26 public static int leapYearCount(int year) { 
27 int leap4 = (year - 1896)/4; 

28 int leap100= (year - 1800)/ 100; 
29 int leap400= (year - 1600)/ 400; 
30 return leap4 -leap100 + leap400; 

31 } 

32 } 

代码 清单 B-14 DayDateFactory.java (最 终 版 本 ) 
1 package org.jfree.date; 

2 


3 public abstract class DayDateFactory { 
4 private static DayDateFactory factory = new 
SpreadsheetDateFactory(); 
5 public static void setInstance(DayDateFactory factory) { 
6 DayDateFactory.factory = factory; 
7 
8 
9 protected abstract DayDate _makeDate(int ordinal); 
10 protected abstract DayDate _makeDate(int day, Month month, int 


year); 


11 protected abstract DayDate . makeDate(int day, int month, int 


year); 
12 protected abstract DayDate _makeDate(java.util.Date date); 
13 protected abstract int. getMinimumYear(); 
14 protected abstract int. getMaximumY ear(); 
15 
16 public static DayDate | makeDate(int ordinal) { 


17 return factory. makeDate(ordinal); 

18 j 

19 

20 public static DayDate | makeDate(int day, Month month, int 
year) 1 

21 return factory. makeDate(day, month, year); 

22 } 

23 

24 public static DayDate makeDate(int day, int month, int year) { 

25 return factory._makeDate(day, month, year); 

26 } 

27 


28 public static DayDate makeDate(java.util.Date date) { 
29 return factory._makeDate(date); 


30 } 

31 

32 public static int getMinimumYear() { 
33 return factory. getMinimumY ear(); 
34 } 

35 


36 public static int getMaximumYear() { 


37 return factory._getMaximumYear(); 

38 } 

39 } 

代码 清单 B-15 SpreadsheetDateFactory.java《〈 最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.util.*; 

4 

5 public class SpreadsheetDateFactory extends DayDateFactory { 
6 public DayDate _makeDate(int ordinal) { 


7 return new SpreadsheetDate(ordinal); 

8 } 

9 

10 public DayDate _makeDate(int day, Month month, int year) { 

11 return new SpreadsheetDate(day, month, year); 

12 } 

13 

14 public DayDate _makeDate(int day, int month, int year) { 

15 return new SpreadsheetDate(day, month, year); 

16 } 

17 

18 public DayDate _makeDate(Date date) { 

19 final GregorianCalendar calendar = new 
GregorianCalendar(); 

20 calendar.setTime(date); 

21 return new SpreadsheetDate( 


22 calendar.get(Calendar. DATE), 


23 Month.fromInt(calendar.get(Calendar MONTH) + 1), 
24 calendar.get(Calendar.Y EAR)); 

25 } 

26 

27 protected int. getMinimumYear() { 

28 return SpreadsheetDate. MINIMUM YEAR, SUPPORTED; 
29 } 

30 

31 protected int. getMaximumYear() { 

32 return SpreadsheetDate. MAXIMUM YEAR, SUPPORTED; 
33 } 

34 } 

代码 清单 B-16 SpreadsheetDate.java (最 终 版 本 ) 


2 * JCommon : a free general purpose class library for the 
Java(tm) platform 
3 * 


5 * (C) Copyright 2000-2005, by Object Refinery Limited and 
Contributors. 
6 * 


55 package org.jfree.date; 

56 

57 import static org.jfree.date. Month. FEBRUARY; 

58 

59 import java.util.*; 

60 

61 /** 

62 * Represents a date using an integer, in a similar fashion to 
the 

63 * implementation in Microsoft Excel. The range of dates 
supported is 

64 *1-Jan-1900 to 31-Dec-9999. 

65 * <p/> 

66 * Be aware that there is a deliberate bug in Excel that recognises 
the year 

67 *1900asa_ leap year when in fact itis not a leap year. You can 
find more 


68 * information on the Microsoft website in article Q181370: 


69 * <p/> 
70 * http://support.microsoft.com/support/kb/articl es/Q181/3/70.asp 
71 *<p/> 


72 * Exceluses the convention that 1-Jan-1900 = 1. This class 
uses the 

73 * convention 1-Jan-1900 = 2. 

74 * The result is that the day number in this class will be 
different to the 

75 * Excel figure for January and February 1900...but then Excel adds 


in an extra 

76 * day (29-Feb-1900 which does not actually exist!) and from that 
point forward 

77 * the day numbers will match. 

78 * 

79 * @author David Gilbert 

80 */ 

81 public class SpreadsheetDate extends DayDate { 

82 public static final int EARLIEST_DATE_ORDINAL = 2; // 
1/1/1900 

83 public static final int LATEST_DATE_ORDINAL = 2958465; // 
12/31/9999 

84 public static final int MINIMUM_YEAR_SUPPORTED = 1900; 

85 public static final int MAXIMUM YEAR SUPPORTED = 9999; 


86 Static final int[] 
AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH = 

87 {0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 
365}; 

88 static final int[] 


LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONT 


89 10, 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 
366]; 

90 

91 private int ordinalDay; 

92 private int day; 

93 private Month month; 


94 private int year; 


95 

96 public SpreadsheetDate(int day, Month month, int year) { 

97 if (year < MINIMUM YEAR SUPPORTED || year > 
MAXIMUM_YEAR_SUPPORTED) 

98 throw new Illegal ArgumentException( 

99 "The 'year argument must be in range" + 

100 MINIMUM YEAR SUPPORTED + " to " + 
MAXIMUM YEAR, SUPPORTED + "."); 

101 if (day < 1 || day > DateUtillastDayOfMonth(month, 
year)) 

102 throw new  IllegalArgumentException("Invalid 'day' 
argument."); 

103 

104 this.year = year; 

105 this.month = month; 

106 this.day = day; 

107 ordinalDay = calcOrdinal(day, month, year); 

108 } 

109 

110 public SpreadsheetDate(int day, int month, int year) { 

111 this(day, Month.fromInt(month), year); 

112 } 

113 

114 public SpreadsheetDate(int serial) 1 

115 if (serial < EARLIEST_DATE_ORDINAL || serial > 


LATEST_DATE_ORDINAL) 


116 throw new IllegalArgumentException( 


117 "SpreadsheetDate: Serial must be in range 2 to 
2958465."); 

118 

119 ordinalDay = serial; 

120 calcDayMonthYear(); 

121 } 

122 

123 public int getOrdinalDay() { 

124 return ordinalDay; 

125 } 

126 

127 public int getYear() { 

128 return year; 

129 } 

130 

131 public Month getMonth() { 

132 return month; 

133 } 

134 

135 public int getDayOfMonth() { 

136 return day; 

137 j 

138 


139 protected Day getDayOfWeekForOrdinalZero() {return 
Day.SATURDAY;} 
140 


141 public boolean equals(Object object) { 


142 if ('(object instanceof DayDate)) 

143 return false; 

144 

145 DayDate date = (DayDate) object; 

146 return date.getOrdinalDay() == getOrdinalDay(); 

147 } 

148 

149 public int hashCode() { 

150 return getOrdinalDay(); 

151 } 

152 

153 public int compareTo(Object other) { 

154 return daysSince((DayDate) other); 

155 } 

156 

157 private int calcOrdinal(int day, Month month, int year) 1 

158 int leapDaysForYear = DateUtil.leapYearCount(year - 1); 

159 int daysUpToYear = (year - 
MINIMUM_YEAR_SUPPORTED) * 365 + leapDaysForYear; 

160 int daysUpToMonth - 
AGGREGATE DAYS TO END OF PRECEDING MONTH[month.toInt( 

161 if  (DateUtiLisLeapYear(year) &&  month.toInt() > 
FEBRUARY.tolInt()) 

162 daysUpToMonth++; 

163 int daysInMonth = day  - 1; 


164 return daysUpToYear + daysUpToMonth + daysInMonth + 


EARLIEST_DATE_ORDINAL; 

165 } 

166 

167 private void calcDayMonthY ear() 1 

168 int days = ordinalDay - EARLIEST_DATE_ORDINAL; 

169 int overestimatedYear = MINIMUM_YEAR_SUPPORTED + 
days / 365; 

170 int nonleapdays = days - 
DateUtil.leapYearCount(overestimatedYear); 

171 int underestimatedYear = MINIMUM_YEAR SUPPORTED + 


nonleapdays / 365; 

172 

173 year = huntForYearContaining(ordinalDay, 
underestimatedYear); 

174 int firstOrdinalOfYear = firstOrdinalOfY ear(year); 

175 month = huntForMonthContaining(ordinalDay, 
firstOrdinalOfY ear); 

176 day - ordinalDay -  firstOrdinalOfYear - 
daysBeforeThisMonth(month.toInt()); 

177 } 

178 


179 private Month huntForMonthContaining(int anOrdinal, int 
firstOrdinalOfYear) | 


180 int daysIntoThisYear =  anOrdinal - firstOrdinalOfY ear; 
181 int aMonth= 1; 
182 while (daysBeforeThisMonth(aMonth) < 


daysIntoThis Y ear) 


183 aMonth++; 


184 

185 return Month.fromInt(aMonth - 1); 

186 j 

187 

188 private int daysBeforeThisMonth(int aMonth) ( 
189 if (DateUtil.isLeapY ear(year)) 

190 return 


LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONT 
= 1; 


191 else 

192 return 
AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH[aMonth] - 1; 

193 } 

194 

195 private int huntForYearContaining(int anOrdinalDay, int 


starting Year) { 


196 int aYear- startingYear; 

197 while (firstOrdinalOfYear(aYear) <=  anOrdinalDay) 
198 aYeart+; 

199 

200 return aYear - 1; 

201 } 

202 

203 private int firstOrdinalOfYear(int year) { 

204 return calcOrdinal(1, Month.JANUARY, year); 


205 j 


206 
207 public static DayDate createInstance(Date date) 1 


208 GregorianCalendar calendar = new GregorianCalendar(); 
209 calendar.setTime(date); 
210 return new SpreadsheetDate(calendar.get(Calendar. DATE), 
211 
Month.fromInt(calendar.get(Calendar MONTH) + 1), 
212 
calendar.get(Calendar. YEAR)); 
213 
214 } 


LE TSE 


2005 年 ， 在 参加 于 丹佛 举行 的 敏捷 大 会 时 ，Elisabeth Hedrickson[1] 
递 给 我 一 条 类 似 Lance Armstrong 热 销 的 那 种 绿色 腕 带 。 这 条 腕 带 上 面 写 
着 “沉迷 测试 ”(Test Obsessed) 的 字样 。 我 高 兴 地 戴 上 ， 并 自豪 地 一 直 
系 着 。 目 从 1999 年 从 Kent Beck 那 儿 学 到 TDD 以 来 ， 我 的 确 迷 上 了 测试 
驱动 开发 。 

MIEREMET ESE., REMH ADER Fii. MEK 
eA, MEHI BERE AE. Pr EREE E 
告 ， 也 是 我 承诺 尺 己 所 能 写 出 最 好 代码 的 提示 。 取 下 它 ， 仿 佛 就 是 违背 
了 这 些 宣告 和 承诺 似 的 。 

所 以 它 还 在 我 的 手腕 上 。 在 写 代 码 时 ， 我 用 余 光 盯 见 它 。 它 一 直 提 
醒 我 ， 我 做 了 写 出 整洁 代码 的 承诺 。 











[11. 原 注 : http://www.qualitytree.com/. 


